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Introduction 


S-Geometry is an integrated system for creating, modifying, and storing 
3D objects. It is window-based and consists of a 3D database and a 3D 
editor. The database is made up of polygons and numerous operations 
that allow you to define, change, and add polyhedra. An object can be 
drawn either orthographically or in perspective. You can select the point 
of view, display backfacing polygons, and define other parameters that 
affect the display. The 3D editor interfaces to the database. It consists 
of a series of menus that allow you to manipulate and display the 
database. You can select features of an object drawn on the screen and 
interactively modify the underlying 3D object. 


The view window provides smooth, dynamic control of the eyepoint. 
S-Geometry is capable of mimicking actual camera attributes, such as lens 
focal length, film format, angle, and point of view. The view window can 
also make line drawings with hidden lines removed, function on color 
displays, hardcopy images, and feed its object and camera data to other 
programs such as S-Render. 


Using the Symbolics window system and graphical input from a mouse or 
tablet, you can create objects by encoding or by employing a full range of 
geometric and topological operations on an object or any of its specific 
vertices, edges, or faces. You can also manipulate the object smoothly in 
three space, with hidden lines removed. 
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Basic Concepts 


S-Geometry creates and manipulates objects in a certain environment, and 
views them with a camera. 


The Environment 


The world in S-Geometry is a Cartesian coordinate space, that is, the 
S-Geometry world is defined in terms of a starting point, known as the 
global origin, and a set of three mutually perpendicular directions, known 
as the major axes. Any point in space can be uniquely defined by three 
numbers, the x, y, and z coordinates, which represent its distance from the 
three planes perpendicular to the major axes passing through the global 
origin. The three directions, together with the global origin, are called the 
global coordinate system. In S-Geometry this coordinate system is "right- 
handed," meaning that although the sign (and the labeling) of the three 
directions is arbitrary, S-Geometry follows the convention that positive y 
represents "up," positive x is "right," and positive z is "forward." 
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It is possible to embed other coordinate systems in the global coordinate 
system. Such embedded coordinate systems, which are referred to as local 
coordinate systems, can have a different origin and their axes can point in 
different directions from the global coordinate system. They can also be 
non-Cartesian coordinate systems. The number of local coordinate systems 
is unlimited, but they are always defined in terms relative to the global 
coordinate system. 
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Camera 


The camera is a special kind of window that incorporates a viewer, a 3D 
geometric entity that is located in the global coordinate system but is not 
currently considered an object in the S-Geometry world. The viewer 
consists of two points in space: a point from which the world is viewed, 
called the eyepoint, and a point toward which the camera is aimed, called 
the aimpoint. The distance between the eyepoint and the aimpoint is called 
the aim-distance, and the direction from the aimpoint to the eyepoint is 
called the camera direction. 


From the eyepoint the camera takes in a certain region of global space that 
is then projected onto the window. Because the window is rectangular, the 
shape of this region is a rectangular pyramid whose apex is at the eyepoint 
and whose sides project away from the eyepoint toward infinity. The angle 
between the left and right sides of this pyramid is called the view angle. 


Because of computational considerations, this region that the camera sees 
does not extend all the way from the eyepoint to infinity, but rather from 
some distance in front of the eye, known as the hither distance, to some far 
off distance, known as the yon distance. The planes perpendicular to the 
line of sight passing through these points are called the hither clipping 
plane and yon clipping plane, respectively. Only objects that fall inside the 
pyramid between these two planes can be visible. This region of visibility 
is called the viewing volume. 


Objects 


An object is actually composed of two parts, a body and a transformation 
matrix. The body can be one of two things: a basic geometric entity, 
which will be called a geobody, or a group of other objects. The 
transformation matrix is a set of numbers that can modify the appearance 
of the object. 


Figure 1.1 Components of an object 
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Body 


If an object’s body is a geobody, the object is referred to as a simple object 
even though the geobody itself can be quite complex. A geobody (for 
example, a polyhedron) is an entity that holds all the essential geometric 
and topological information of an object. It is what makes an object 
recognizable as a form, what makes a cube a cube. It is frequently built 
up from other geometric entities, called elements, but is itself self-contained. 
A cube, for example, is a polyhedron comprised of six face elements, which 
in turn are defined by vertex elements located at particular points in space 
and topologically interconnected in a certain way by edge elements. Among 
the geobodies defined by S-Geometry are isolated points and line segments, 
wires (contiguous segments), and polyhedra. 


Figure 1.2 Object with a geobody for its body 


While a geobody is a unique entity, it cannot be viewed or manipulated in 
S-Geometry without being instanced, that is, being the body of some object. 
It is possible for two (or more) objects to share a single geobody. A 
geobody which belongs to more than one object is said to be multi- 
instanced. 


4 e §$-Geometry 


‘Transformation |_| 
ce ee 


Figure 1.3 Reinstanced objects 


An object whose body is a group of objects is called a compound or multiple 
object. Each member of the group is an object complete with its own body 
and transformation matrix, and can in turn be either a simple or compound 
object. Thus with repeated nesting a single object can consist of hundreds 
of geobodies. 


Figure 1.4 Compound object 
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Transformation Matrix 


The transformation matrix modifies the apparent geometry of an object. 
An object can be made to look like it is in a location other than where the 
information in its body says it is; the matrix can also make objects look 
larger or smaller, stretched, or rotated. 


Modifying the matrix is in effect modifying the coordinate system in which 
the object is embedded. It does not affect the body of the object at all but 
only its appearance in the world. The raw data of a body exist in the local 
coordinate system of the body’s object, which is initially coincident with the 
global coordinate system. When you modify the transformation matrix of 
the object you separate the local coordinate system from the global 
coordinate system. For example, a polyhedron might have all its vertices 
centered around the origin. Applying a translation transformation to the 
polyhedron’s object displaces the space in which the polyhedron is defined. 
The polyhedron’s vertices are still centered around the local origin but are 
now far from the global origin because the local space has moved relative 
to the global coordinate system. 


When there is no difference between the local coordinate space of an object 
and the global coordinate space, that is, the effect of the object’s 
transformation matrix is to leave the object in the same position from 
which it started, the transformation matrix is said to be an identity matrix. 
An object with an identity transformation matrix is said to be in its home 
position. 


Each object, including an object that has been reinstanced, has a unique 
transformation matrix. This is what makes sharing geobodies feasible, 
since a single geobody can be made to appear to be in different locations 
with different sizes or shapes simply by belonging to objects with different 
transformation matrices. 


The matrix itself is just an array of sixteen numbers that is used to change 
the drawn position of each point in an object. Because it is such a small 
data structure, it is easy to change and can be considered more volatile 
than the geometric information in the body. S-Dynamics, for example, 
replaces the values in the transformation matrices of animated objects with 
its own numbers. 


An object can be forced into the global coordinate system by a process 
called baking. This operation transfers all the information in the 
transformation matrix down into the raw data of the body, in effect shifting 
the local coordinate system out from underneath the body to make it 
coincide with the global coordinate system, and so making the apparent 
position of an object its home position. 
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Changing the Body vs. Changing the Body Transformation Matrix 


The 3D editor allows you to make many different types of changes to an 
object. Some changes can be made only to the body itself. These are 
topological changes, which affect the interrelationships between elements of 
a body, and local deformations, which affect some points of the body but 
not others. Some changes, the so-called rigid-body transformations 
(translations, scalings, rotations and shears), can be made either to the 
body as a whole or to the transformation matrix of the object to which it 
belongs. The changes are very different, but the effects can appear 
identical. 


Operations are specified relative to some coordinate system. When you 
transform an object, the transformation can be applied in any coordinate 
space. Modifications to the body are always in the home or local coordinate 
space of the body’s object. When the object is in its home position it is 
impossible to visually distinguish a transformation from an equivalent body 
modification. 


But you must always be aware whether you are changing the object’s body 
or its transformation matrix. Modifications to the body change the data in 
each primitive element of the body, while changes to the transformation 
matrix affect only the appearance of the object. It is easy to initialize 
(erase) the transformation matrix to undo any changes made to the 
appearance. Changes made to body, however, are permanent and can only 
be negated by subsequent opposite changes. Because it is easy to undo, it 
is generally better to make even intended permanent changes as trans- 
formations first, later baking the object in its final shape. 


Figure 1.5 shows which S-Geometry menus modify which part of an object. 


Operations available on [Transform Object] of the MAIN menu operate only 
on the transformation matrix. The element modification menus, which are 
accessed from [Modify Element] of the MAIN menu or by clicking (M2) in 
the view window when an element is selected, operate on the object’s body, 
thus permanently changing the geometry of the object. Note: Menus that 
operate on collections of elements are accessed in the same way as element 
modification menus. 
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Figure 1.5 S-Geometry menus that affect the body and 
transformation matrix 


Object Hierarchy 


A multiple object can also be visualized as a hierarchy. In this form, the 
nesting of objects is displayed spread out in levels, with the containing 
object at the top. The containing object is called a top-level object. Objects 
that comprise the body of a top-level object are called inferiors, or inferior 
objects. Objects that have inferiors are referred to as the superior of those 
objects. Simple objects with no inferiors are often called terminal objects, 


because the tree structure ends with them. 
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Figure 1.6 shows the hierarchy of a top-level object, which is represented by 
the single rectangle at the top. It has for its body a list of objects. The 
objects that make up the list are represented by the four rectangles 
immediately below the top-level object. 


The leftmost rectangle has for its body a geobody, in this case an icosa- 
hedron. The hexagonal shape between the object and body is a body- 
display-item (bdi) which is inserted and used by the 3D editor for storing 
display information. | 


The middle two inferior objects are instanced. They share the same geo- 
metric information, but their transforma<ion matrices and bdis (repre- 
sented by hexagons) are different. The two objects might look completely 
different from one another. The rightmost inferior object is a compound 
object and is itself made up of a list of objects. 


Object 
(top-level) 
as a ee ae 
Object Object 
(inferior) (reinstanced) 


Way Geobody 


Figure 1.6 Hierarchy of a top-level object 
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Getting Started 

rt 

This chapter describes how to load S-Geometry, use the mouse and keyboard, 
i and get around the geometry frame. 

The minimum software requirement for running S-Geometry is 8 Mbytes of 
vi memory. Color hardware and color memory are not required unless you need 

to view objects that have been rendered or shaded. Other options include 
— 32 Mbytes of memory, an FPA, GTCO or Kurta tablet, Bitstream fonts, 
ry. : 
— S-Render, and S-Dynamics. 
Fil 

Loading and Entering S-Geometry 

am 


If S-Geometry is not part of your world load, you can load it explicitly by 
typing the Command Processor command Load System s-geometry. If you 
rh don’t know whether S-Geometry is loaded, use mn-k Show Herald to view the 
current world load. 


Ub There are several ways to enter S-Geometry once it has been loaded: 
a e Select [Geometry] in the SYSTEM menu. 
Bi 
e Press SELECT G. 
ant 


Note: The Graphic Editor is part of the base system and is originally 
assigned to SELECT G. When S-Geometry is loaded over the base system, 
WI a prompt gives you the option of assigning the Graphic Editor to 

ger SELECT T (SYMBOL G) so that S-Geometry gets SELECT G. 


) a To change the assignment of SELECT G, press Select = to bring up a 

rae table that allows you to assign activities to keys. 

nr e Type :Select Activity to a Lisp Listener and when prompted type 
geometry. 

— | e Call the function make-3d-editor. 

or The first time S-Geometry is selected after a cold boot, it might take four 

— minutes for it to come up. To exit S-Geometry, select another program. 
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Using the Mouse 


The mouse is a pointing device that you move around on a flat surface. 
The motions of the mouse are sensed by the Lisp Machine, which responds 
by moving a cursor around the screen in a corresponding manner. The 
shape of the cursor depends on the context. 


Mouse Buttons 


The three buttons on the mouse are referred to as left, middle, and right. 
By clicking these buttons, you tell S-Gesmetry what you want to do. 
Exposed windows and menus are sensitive to mouse clicks. Clicking in the 
view window, for instance, brings up the MAIN menu or begins or stops 
camera motion. Clicking on a menu item initiates the action described by 
the menu item. 


Mouse actions in this document are represented in the following manner: 


Appearance What you do 

Gis (NDB) Click right, click middle, and click left. 
(R2), (M2), (L2) Click right twice, click middle twice, 
or and click left twice. Double mouse 
(sh-R), (sh-M), (sh-L) clicks can be duplicated by holding 


the SHIFT key and clicking the 
appropriate mouse key. 


(c-L) Press the CONTROL key and click the 
appropriate mouse key. 


(m-R) Press the META key and click the 
appropriate mouse key. 


(R)-hold Click the appropriate mouse key and 
hold while moving the mouse. 


Mouse Notation in Menus 


Menu items that are preceded and followed by a period have multiple 
selections, which you select by clicking right, middle, or left on the mouse. 
(The different options are shown on the mouse documentation line, 
displayed in reverse video at the bottom of the screen.) 
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This document uses the following notation for using mouse buttons when 
selecting menu items: 


e When a menu item is written without additional mouse notation, such as 


[Create], place the cursor over the menu item Create and click the left 
mouse button. 


e When a menu item appears followed by mouse notation, place the cursor 
over the menu item and follow the mouse notation instructions. For 
instance, [Create (R)] means to place the cursor over the menu item 
Create and click right. 


Menu Conventions 


For menus that require you to type in data, move the mouse so the item is 


highlighted. Type in the information and press the RETURN key to "set" the 
data. 


In cases where None is a choice, do not type None. Instead, press the 
RETURN key. 


Geometry Frame 


When you first enter S-Geometry, you see the window-based work area of 
S-Geometry. This work area, which is called the geometry frame, contains 
windows and menus that allow you to display and control the geometric 
objects you create or modify. 


The geometry frame is "alive": you can select alternate configurations of the 
frame, manipulate and alter its windows and menus, create new windows, and 
perform many other operations such as exposing and deexposing windows, 


_ hiding, burying, and revealing panes, and even setting the density of the back- 


ground gray. See Chapter 10—"Live Window Environment" for specific 
instructions for these operations. 


The following paragraphs give only brief descriptions of the windows and 
menus of the geometry frame. 
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Figure 2.1 Geometry frame (shown with Main menu) 


View window Displays the camera’s view of geometric objects you cre- 
ate or modify. The view window is a 2D viewport into a 
3D environment. 


Additional view windows can be created to display vari- 
ous camera views. See the section "Adding a New View 
Window" on page 31. 


Camera Motion menu Allows you to specify the different camera motions. See 
Chapter 3—"Viewing Objects." 


History window Provides an extended history of all forms in the Lisp 
Listener. You can select a line in the history window to 
reexecute a command or get its value. 


Sensitivity Element menu 
Specifies what type of geometric element is highlighted 
in the view window. Once an element is highlighted, it 
can be selected so various operations can be performed 
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Basic Interface menus 


Four basic interface menus allow you to manipulate objects and change 
camera characteristics. Each menu is described fully in a separate chapter. 


e The CAMERA menu describes the characteristics of the camera. See the 
section "Camera Menu" on page 31. 


e The UTILITIES menu contains a variety of useful operations to perform on 
objects. See Chapter 5—"Managing Objects." 


e The OBJECT DISPLAY menu controls which objects are displayed and how. See 
Chapter 7—"Displaying Objects." 


e The OUTPUT menu directs objects to color windows and output devices. See 
Chapter 8—"Ouputting Objects." 


3D live window 


The 3D live window is a Lisp Listener. It allows you to use Lisp to examine 
or create new geometric constructs. 


A variety of operations specific to geometric objects can be performed in the 
3D live window. Examples of operations performed in the 3D live window 
include the following: 


e Binding symbols to selected elements. 


Highlighting, selecting, and printing information about bound elements. 


e Finding out about particular flavors or instances of flavors, such as opera- 
tions handled by an instance, init options to a flavor, flavor dependencies, 
method hierarchies, and argument lists for functions and methods. 


e Typing messages to objects and elements. 


For specific information about these operations, refer to Chapter 10—"Live 
Window Environment." 
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Main Menu 


Objects are added to the environment, transformed, and modified from the 
MAIN menu. (R) when the cursor is in the view window to display the MAIN 
menu. 


Overlays. 
List Object= 
Add New Object 


. Transform Object. 
~ .Modify Element. 
. Attributes. 


[Overlays] Shows coordinate axes, a field chart, or TV safe 
areas for one frame only. See page 16. 


TF ov Objects] Lists the names, types, and element counts for 
some or all objects. See next page. 


[Add New Object] Reads, creates, or encodes a new object. See 
Chapter 4— "Creating and Transforming 
Objects." 


[Transform Object] Moves, scales, or rotates an object by changing 
its transformation matrix. See Chapter 4— 
"Creating and Transforming Objects." 


[Modify Element] Modifies the geometry of currently selected 
elements. See Chapter 5—"Manipulating 
Objects." 


[Attributes] Sets such attributes as color and opacity for 
currently selected elements for S-Render. 
Appears only if S-Render is loaded. Attribute 
settings are explained in the manual S-Render. 
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Listing Objects 


[List Objects] lists in the live window the names, types, and element counts 
for all objects and subobjects. 


[List Object (M)] lists the names, types, and element counts for the visible 
objects and subobjects only. 


[List Objects (R)] brings up a menu of all objects from which you can select 
only those objects that you want listed. 
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3d Live Window 1 


Figure 2.2 Printout from [List Objects] 
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Frame Overlays 


You can display three types of overlays for a single frame. 


[Overlays] 


[Overlays (M)] 


overlays (R)] 


Displays global axes (x, y, z). The coordinate 
system used in S-Geometry is right-handed, 
with the y axis representing "up." The 
negative uirection on each axis is marked by a 
gap between the origin and start of the axes. 
(The gap is adjustable from the PARAMETERS 
submenu of the CAMERA menu.) The x and z 


axes are connected by a line. 


Displays a 12-field chart. The field chart (24 
x 24) is useful in animation when movement 
of objects must be plotted. 


Displays rectangles that outline TV safe 
areas. Objects that fall outside the dotted 
rectangles might be lost when the frame is 
broadcast to a TV screen. Titles or other 
essential information should be kept within 
the smaller rectangle, which represents a 
"worst-case" cutoff. The size of the 
rectangles can vary. Rectangles are smaller 
when the aspect ratio is considered a film 
format to account for film-to-tape transfer 
losses. 


Each overlay can be turned on permanently from the [Parameters] item of 
the CAMERA basic interface menu. 
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Figure 8 Global axes 
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Figure 9 Field chart 
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Viewing Objects 


Objects in the view window are viewed through a viewport, which is called 
a camera. As with a real camera, you can control the motion and aim of 
the view port as well as the width of the view angle and even such camera 
parameters as film format. 


Camera Motion Menu 


How the camera responds to the mouse movement is determined by the 
CAMERA MOTION menu, which appears at the bottom of the view window. 


[Zoom +] controls the width of the view angle and sets the placement of 
the clipping planes. 


[Rotate] and [Translate] are camera motions; they determine whether the 
camera moves along circular or linear axes. 


[Fixed-aim] and [Global] modify the camera motions. [Fixed-aim] constrains 
the camera to aim at a particular aimpoint. [Global] modifies the camera’s 
frame of reference. Frame of reference refers to what direction is 
considered "up," "down," "left," or "right." The motions and modifiers can 
be set separately. 


To begin camera motion, (L) in the view window and move the mouse. 


tg 
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zoom 


[Zoom +] interactively changes several camera parameters to adjust the 
camera’s view angle. (M)-hold to switch the camera to a linear motion, 
toward and away from the aimpoint. [Fixed-aim] and [Global] are not used 
in this operation. 


[Zoom +] Changes the zoom of the camera, that is, it 
| adjusts the camera’s view angle. (M)-hold to 
put the camera in truck mode (moving toward 
and away from the aimpoint). By alternately 
zooming and using truck mode, you can adjust 
the perspective effects while keeping the size of 
the object on the screen relatively constant. 


[Zoom + (M)] Adjusts the hither and yon clipping planes. This 
adjustment does not work if [Auto Ranging] is 
on. ({Auto Ranging] is turned on from the 
PARAMETERS Or MODES submenu of the CAMERA 
menu.) 


[Zoom + (R)] Allows you to set an explicit view angle and 
hither and yon distances with the following 
menu: 


Specify New View Anale: 


Lens f.1. mm) : 17.68243 
View angle (deg): 71.33673 
Hither distance : 1.8 

Yon distance : 50660.G 
Set Auto Ranging: On orf 


Set View Angle [ Bbonter 


Rotations and Translations 


[Fixed-aim] is automatically enabled when you (L) to select a motion type. 
To turn off [Fixed-aim], (M) when you select [Rotate] or [Translate]. To 
set explicit values from the keyboard for the motion types, (R) when 
selecting the motion type. 


Rotations are of two types, pans and swings, depending on whether [Fixed- 
aim] is on. 


[Rotate] Swing. During a swing, the camera follows a 
circular path around a particular aimpoint, 
constantly reorienting itself to remain fixed on 
this aimpoint. 
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[Rotate (M)] Pan. Rotates the camera around its center with 
the eyepoint fixed. Since [Fixed-aim] is turned 
off, the aimpoint moves with the camera. 


[Rotate (R)] Allows you to set an explicit orientation with the 
following menu: 


Specify New Camera Orientation (degrees): 
e (azinuth : 12.499999 
b (altitude) : 13.3068061 
c (rol}) : 8.8 

Ain fixed? : Yes No 


Set Orientation © Abort [) 


Linear translations of the camera are divided into moves and shifts. 


[Translate] Move. A linear translation with [Fixed-aim] on. 
The camera compensates for its displacement by 
panning to maintain the aimpoint. 


(Translate (M)] Shift. A linear translation with constant camera 
orientation. The aimpoint shifts with the camera. 


[Translate (R)] Allows you to set an explicit eyepoint with the 
following menu: 


ew Camera Lo 
: -49.686836 


DN < XP 


: 6.6834116 
: 118.92479 
im fixed?: Yes No 


Camera Modifiers 


[Fixed-aim] makes the camera change its orientation during a move so the 
camera remains pointed at a particular aimpoint. The aimpoint is the point 
at which the camera is aimed and is often the center of an object. 


When [Fixed-aim] is off, the camera’s orientation stays constant so the 


aimpoint moves with the camera—objects seems to "drift" in the view 
window. 


To explicitly specify an aimpoint, use [Fixed-aim (R)] to bring up the 
following menu: : 


Ses elLeSZ 
: 5.722646e-6 


: -6.1635156e-5 
ye fixed?: Yes No 
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[Global] chooses between a global or coordinate system to determine 
rotation and motion axes. When [Global] is enabled the camera is moved 
along the global x, y, and z axes, and the rotation ignores the camera’s 
orientation; the direction up is determined by the global y axis. 


When [Global] is not enabled, a local coordinate system is in effect, that is, 
the rotation and motion axes are determined by the camera’s local x, y, and 
z axes, and the rotation depends on the camera’s orientation. 


Camera Motions 


All possible camera motions are diagramined on the next few pages. Each 
diagram shows the camera in three positions. The shaded camera shows 
the camera’s initial position, which is the same for each diagram. The two 
wireframe cameras represent the camera position after two mouse motions, 
once when the mouse is moved right and once when the mouse is moved 
back (toward you). The large arrows represent the possible camera 
motions. The small arrow or pivot axis represents the motion of the 
camera when you (M)-hold. 


The small diagrams show the scenes in the view window. The center view 
window shows the scene of the camera’s initial position. The view window 
on the left shows the scene when the mouse is moved back (toward you); 
the view window on the right shows the scene when the mouse is moved 
right. - 


The global axes are displayed to make it easier to compare the differences 
between global and local coordinate systems. When [Global] is enabled, the 
motion axes are parallel to the displayed axes. When [Local] is enabled, 
the motion axes are determined by the camera’s frame of reference. 


Initially the camera is aimed at the figurehead, which is looking down the z 
axis. Notice that during moves and swings, the camera remains aimed at 
the figurehead no matter where the camera is moved, and the figurehead 
remains centered in the view window. However, during pans and shifts, 
the camera’s aimpoint is free to move, and the figurehead appears to drift 
in the view window in a direction opposite to that of the mouse movement. 
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Swing Global 


In this mode the camera moves along the longitudes and latitudes of a 
vertically oriented globe that is centered about the aimpoint. [Fixed-aim] is 
enabled during a swing, so as the camera moves, it orients itself to remains 


fixed on the aimpoint. An object being viewed remains centered in the 
view window. 


Notice that since [Global] is enabled, the motion axes are parallel to the 


global axes. This mode is especially helpful because it lets you view the 
object from any side. 
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Swing Local 


Swing Local resembles Swing Global in that the camera moves along 
longitudes and latitudes of a globe centered around the aimpoint. However, 
since [Local] is on, the rotation depends on the camera’s orientation, not 
the global coordinate system. Up is determined not by the global y axis, 
but by the camera’s orientation. Notice that the motion axes are 
determined by the angle of the camera. 
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Pan Global 


In this mode the camera remains stationary and rotates around its center 
as the mouse is moved. Notice that the rotation axes are parallel to the 
global axes. 


During a pan [Fixed-aim] is off, so the camera does not reorient itself to 
remain aimed at the object and the aimpoint moves with the mouse. An 
object that is being viewed appears to drift through the view window in a 
direction opposite to the mouse movement. 
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Pan Local 
ae eG ES transiate global Fined=ain 


Pan Local resembles Pan Global in that the camera remains stationary and 
rotates around its center. However, since [Local] is enabled, the camera 
rotates on axes that are determined by the camera’s orientation, not by the 
global axes. The rotation axes are determined by the camera’s frame of 
reference and are not necessarily paraliel to the global axes. 
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Move Global 


trans) ate 


fixed-aim 


In this mode, the camera moves linearly along the global x, y, and z axes. 
[Fixed-aim] is enabled during a move, causing the camera to change its 
orientation to remain pointed at the aimpoint. 


An object that is being viewed appears to move along one of the global axis 
while it remains centered in the view window. 
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Move Local 


translate 


This mode resembles Move Global except that the axes along which the 
mouse moves are determined by the camera’s initial orientation. Up is 
determined by the camera’s initial orientation, not the global y axis. Notice 
that the motion axes are not parallel to the displayed axes but are 
determined by the angle of the camera. 
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Shift Global 


In this mode the camera moves linearly along the global x, y, and z axes. 
In a shift, [Fixed-aim] is turned off, so the object appears to drift through 
the view window in a direction opposite to the mouse movement. 
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Shift Local 


Shift Local differs from Shift Global in that the axes along which the 
camera moves are determined by the camera’s local coordinate system, not 
the global axes. Notice that the motion axes are not parallel to the 
displayed axes but are determined by the camera’s frame of reference. 
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Camera Menu 


You can adjust certain parameters of the view window camera to simulate 
such real-camera parameters as film format and lens focal length. 


| 


m 
Parameters 
ct Modes 
mt Views. 
nap Align. 
Aim 
7 Level 


Descriptions of the CAMERA submenus and their items follow. Most of the 
a menu items are specialized. In most cases the default settings should not 

have to be changed. You can skip this section until you are more familiar 
with S-Geometry. 


1a Adding a New View Window 


[Add New Viewer] allows you to create a second view window in which an 
im) object can be displayed from a second camera angle. There is no limit to 
the number of view windows that can be created; however, the more view 
windows in use, the slower the system responds for certain functions. 


[Add New Viewer] Adds a new view window but leaves the 
geometry frame otherwise unchanged. 


[Add New Viewer (R)] Adds a new viewer and turns off display of the 
on four basic interface menus, providing additional 
- room for the new viewer. The menus are still 
accessible and are listed by name on the MAIN 
in mentu-—CAMERA, OBJECT DISPLAY, UTILITIES, and 
“4 OUTPUT. The respective menu is displayed 
whenever the mouse is moved onto its name. 


After selecting [Add New Viewer] or [Add New Viewer (R)], you are asked 
to use the mouse to position the upper-left corner of a rectangle that 

uD indicates the position of the new view window; you then use the mouse to 
position the lower-right corner to indicate the size of the new view window. 
The new viewer can be positioned anywhere on the geometry frame and can 
be any size. 
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3d Live Window 1 


Geometry frame with new view 
window added and the four basic interface menus 


listed on the Main menu. 


Figure 3.2 [Add New Viewer (f)/ 
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Parameters Submenu 


Use [Parameters] in the CAMERA menu to display the following menu: 


Modify Camera Parameters 
» | 


reen RETCH Factor: 
Mouse SPEED (17180) : 18 
TRANSLATION Mouse Fac: 1.8 
Menu Flonum Precision: 2 
TIMEOUT Time : @ 
Redraw After Config : Leave alone Automatically Update Image 


HITHER/ZYON Planes : Fixed Auto-adjusting 
Viewing DEPTH ratio : @.8 
Minimum HITHER dist : none 


MAJOR AXES : Hidden Visible 
Major Axis LENGTH : 160.8 

Major Axis GAP width : 1.5 

Major Axis STYLE : Plain Labeled 


Object ADDITION MODE : Append Prepend 

FACE Display : Opaque Transparent 
Ob ject RITACHMENTS : Visible Hidden 
Substitute Boxes Move only Always 
Point Display RADIUS : 3 

Element SERIAL NUMS : Don’t Monitor Monitor 


Collection Display : Show Visible Onty Show All 
Collection Universe : Within Body Only Giopa! 
Default Editing Mode : Qee interactive Geo Numeric Attributes 


Gticky OVERLAYS : No Yes 
Field Chart ; No TV-Safe 


Global UNITS : FEET 
Camera FORMAT : Any 16 35 Acad 1.85 Pan 70 UltraP Vista 3Sstill NTSC PAL HDTV HiRes 
Override Color Window: No Color Window 


et Camere Parameters Abort [3 


TV-Safe Area Marked 


Note: Many of these menu items are also found on the MODES submenu 
0 (see section "Modes Submenu" on page 39), which comes up much faster 
= than this menu. 


in Screen Stretch Factor The shape of monitor pixels varies, depending on 
= the internal adjustments of each monitor. Most 
Symbolics black-and-white console monitors do not 
us have square pixels. [Screen Stretch Factor] 

mS compensates for the spatial asymmetry in x and y 
by stretching in x. The default stretch is 1.12. 

th The value should vary for each type of terminal 
and the particular settings of each monitor. 


— Mouse Speed Multiplies the mouse inputs by this number. The 
default is 25. Decreasing the mouse speed : 
Tl decreases the effect of moving the mouse, so you 


have to move the mouse more for the same effect. 
Increasing the mouse speed increases the effect of 
ww moving the mouse. 


a Translation Mouse Fac Applies a factor (multiplier) to the mouse speed, 
= allowing you to control how much a selected 
element is moved. Controlling the speed of a move 
operation is helpful in situations when you have 
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Menu Flonum Precision 


Timeout Time 


Redraw After Config 


Hither/Yon Planes 


Viewing Depth Ratio 


zoomed in on an element. No mouse movement 
occurs when the factor is set to 0. The default 
is 1, normal mouse movement. 


Determines how many digits to the right of the 
decimal are displayed. This item does not affect 
the number’s precision but only how the precision 
is displayed. The default is 2. 


Attempts to draw a face for the specified number 
of jiffies (1 jiffy = 1/60 second) and then gives up. 
This is useful when you are creating objects that 
do not conform to the database rules and might 
result in infinite loops. The default timeout is 
none. 


[Automatically Update Image] automatically 
redraws the image in the view window whenever 
there is an external change of size or configur- 
ation, such as when a new configuration is set. 
Automatically updating the image ensures that the 
view is always correct, but might create a pause 
during the configuration if the current scene is 
very complex. The default is [Leave Alone]. 


[Auto-Ranging] continuously adjusts the hither and 
yon clipping distances based on the previous frame. 
(The hither and yon planes are moved with the 
[Zoom +] selection on the CAMERA MOTION menu.) 
[Fixed], the default, keeps the hither and yon 
clipping distances constant. Auto ranging mode 
can also be enabled from the MODES submenu. 


At least part of an object must be visible or the 
hither and yon clipping planes are not updated. 
For this reason, it is recommended that [Auto 
Ranging] be turned off when parameters such as 
eyepoint and location of object are explicitly set 
since explicit settings might move the object 
beyond the hither and yon clipping planes. 


Sets the hither and yon clipping planes to a 
certain distance in front of and behind the 


geometric points that are closest and farthest when 


[Auto Ranging] is on. The amount of "headroom" 
is specified by this ratio, which can be a number 
from 0 to 1. 
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o 

me Minimum Hither Dist Even with [Auto Ranging] enabled, sets a 

iw minimum hither distance from the eye. The 
disadvantage of setting a very small minimum 

' hither distance is that the depth precision becomes 

= very small the closer the hither plane is to the 
eye. 

1 | | 

we Major Axes Determines whether the global axes are displayed 

. continuously. The default is [Hidden]. Display of 

ia the axes can also be enabled from the MODES 
submenu. 

iL Major Axis Length Specifies the length, in global units, of the x, y, 
and z axes. 

" 


Major Axis Gap Width Specifies the length of the gap between the origin 
and the negative x, y, and z axes. The gap gives a 

w visible indication of which axis is positive and 

a7 which is negative. 


i Major Axis Style [Labeled] displays the letters "x," "y," and "z" at 
the positive ends of the major axes arms. The 
default is [Labeled]. 


a 
Object Addition Mode Determines whether the latest object is added to 
D1 the bottom (the default) or top of menus. 
e Face Display [Opaque] uses a painter’s algorithm to display the 
te object elements in the view window, providing a 
view with hidden lines eliminated once interactive 
a camera motion has stopped. This option is 


= intended to give a rough idea of which surfaces 
are hidden. It does not give reliable face 

1% intersection information. [Transparent] draws the 

_ scene as if faces were transparent. Face display 
can also be set from the MODES submenu. 


Object Attachments Determines whether object attachments such as 
scaling centers, rotation axes, and other subobjects 
(at are visibly displayed. Display of attachments can 
also be set from the MODES submenu. 


= Substitute Boxes Determines whether substitute boxes are used only 
during camera motions or at all times. The 

n default is [Move Only]. 

ia 

= 
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Point Display Radius 


Element Serial Nums 


Collection Display 


Collection Universe 


Default Editing Mode 


Sticky Overlays 


Specifies the radius, in pixels, of a point object 
such as a scaling center. The valid values are 1 
to 4. The default is 3 


[Monitor] displays the serial numbers of 
highlighted elements in the upper-left corner of 
the view window. The default is [Don’t Monitor]. 
Serial number display can also be set from the 
MODES submenu. 


[Show All] highlights points and segments that are 
collected but currently hidden from view. The 
default, [Show Visible Only], highlights only those 
collected points and segments that are currently 
visible. 


[Global] allows you to collect across unrelated 
objects. The [Global] setting is recommended only 
for attributes and should be used with care. The 
default, [Within Body Only], allows collections to 
be made from one body only. 


Determines what action or menu occurs when you 
(M2) when an element is selected. When [Geo 
Interactive] is enabled, transformations and 
modifications are controlled by moving the mouse. 
When [Geo Numeric] is enabled, a menu appears 
to enable you to type in explicit values for 
transformations and modifications. [Attributes] 
editing mode brings up a menu for rendering 
attributes when you (M2). 


While [Geo Interactive] is enabled, you can get the 
menu for numeric values by pressing the CONTROL 
kev while pressing the appropriate mouse key. 
(While in numeric mode, CONTROL click gets you 
interactive mode.) While in attributes mode, 
geometry modifications can be made from the MAIN 
menu. 


Attribute or geometric editing can also be set from 
the MODES submenu. 


Displays the 12-field chart or TV safe areas 
continuously. 
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Field Chart 


Global Units 


Camera Format 
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Specifies whether TV safe areas are displayed with 
the field chart. 


Specifies the unit by which distances and sizes are 
measured. The default is feet (FT). Other 
possibilities are inches, yards, miles, millimeters, 
centimeters, meters, and kilometers. Only useful 
when objects are specified in different units so 
that they can be scaled properly. Changing the 
global units scales all the objects in the world and 
the location of the camera. The effect is not 
visible, but the coordinates of all bodies are 
changed. 


There are three kinds of camera formats. One 
corresponds to real cameras and describes aspect 
ratio and focal length. Another corresponds to 
video formats and describes only the aspect ratio. 
A third, [Any], describes neither focal length nor 
aspect ratio but allows you to assign any aspect 
ratio by sending the :set-aspect-ratio message to 
3d:camera. 


16 

35 
Acad 
Pan 

70 
UltraPan 
Vista 
35Still 
NTSC 
PAL 
HIRES 
HDTV 


16mm cinema format 
35mm cinema, full aperture 
35mm Academy aperture 
Panavision 

70 mm unsqueezed 

Ultra Panavision 
Vistavision 

35mm still camera 

NTSC video format 

PAL video format 
Symbolics high-resolution color monitors 
High-definition video 


Aspect ratio: 1.369 
Aspect ratio: 1.333 
Aspect ratio: 1.371 
Aspect ratio: 2.361 
Aspect ratio: 2.287 
Aspect ratio: 2.75 

Aspect ratio: 2.301 
Aspect ratio: 1.500 
Aspect ratio: 1.333 
Aspect ratio: 1.333 
Aspect ratio: 1.25 

Aspect ratio: 1.778 


See the American Cinematographers Guide, published by the American 
Society of Cinematographers, for detailed information about each film 
format. 
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Override Color Window 


NTSC video format is the default. You can, 
however, specify in your site namespace object a 
default format. This means that any time any 
machine makes a new camera window, it can 
default to a format common to your site. This is 
most helpful if you have several machines at your 
site. 


You need do this only once. To enter the default 
format in your site namespace, type the command: 


:-Edit Namespace Object Site <your site name> 


Go down to the entry named User Property (or the 
last such entry if there are several). Click on 
Global Name and type Default-Camera-Fornmat. 
Click on Token and type which format you wish, 
e.g. HDTV. Then use [Save] to permanently 
update your site namespace object. 


You can override the site camera format default 
locally by setting the variable 3d:*default-camera- 
format* (default is nil) to a string representing 
your desired format. For example, to set the 
global variable to HDTV, type the following to a 
Lisp Listener before you make your view window: 


(setq 3d:xdefault-camera-formatx “hdtv") 


Setting a default format or overriding it locally 
affects only the initial state of the view window. 
You can make any subsequent changes to the 
format in all the same ways as before. 


S-Geometry allows you to output line drawing to a 
color window instead of the view window. ~ 
[Override Color Window] enables you to choose a 
color window to use as an alternate output. The 
default is [No Color Window]. 


If you do not have color hardware, clicking (L) or 
(M) brings up a menu that allows you to create a 
bitmap screen. See the section "Creating Color 
Windows without Color Hardware." 
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= in 
a 
= | Modes Submenu 
i — The MODES submenu lists some of the commonly used menu items of the 
——_ PARAMETERS submenu. 
| 
sa i Auto Ranging 
|| Opaque Faces 

S Visible Axes 
= 6 Serial Numbers 

a Visible Attachments 
| Sticky Substitute Boxes 
= a 
li You can set up the MODES menu so that it lists only those parameters you 
o © change often. Using the CONTROL key when selecting the MODES menu 

Pm brings up the following menu that lists a number of switches from the 
| PARAMETERS menu that can appear on the MODES menu: 
= 
| Auto Ranging : ¥e 

ator Opaque Faces : Yes No 
| am) Visible Axes : Yes No 

= Labelled Axes : Yes No 

Serial Numbers : Yes No 

] Visible Attachments : Yes No 
"7 Ir Sticky Substitute Boxes : Yes No 

— Sticky Overlays : Yes No 
| Numeric Input Default : 

Attribute-edit Default : 

= Set New Mode Items [ 
| ae © 7 
I . Auto Ranging Enables auto ranging mode, which automat- 
i ically adjusts the hither and yon clipping planes 
[| based on the previous frame. When auto 
—" ranging mode is turned off, the hither and yon 
q = planes are fixed, or constant. 
= IF Opaque Faces Specifies removal of hidden lines when camera 
t “ae motion stops. 
——— Visible Axes Continuously displays the x, y, and z axes in the 
[ view window. 
= IY 

me Labeled Axes Displays the letters "x," "y," and "z" at the 

ae positive ends of the major axes arms. 
= IT 
im 
= Vm 
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Serial Numbers 


Visible Attachments 


Sticky Substitute Boxes 


Sticky Overlays 


Numeric Input Default 


Attribute-Edit Default 


View Submenu 


Displays the serial number of the highlighted 
element in the upper-left corner of the view 
window. | 


Displays scaling centers and rotation axes, if 
any, in the view window. 


Displays substitute boxes for selected objects at 
all times. 


Displays the 12-field chart or TV safe areas 
continuously. 


Brings up a menu that allows you to type in 
explicit values when you (M2) with an element 
selected. 


When an element is selected, the attribute-edit 
default determines what kind of menu is 
displayed when you (M2): one for geometric 
editing or one for attribute editing (for render 
or shading). Whatever default is selected, the 
alternate mode of editing is available from the 
MAIN menu. 


A view is a data structure that describes the camera’s position and aim 
location (as well as other camera parameters, such as view angle and 
aspect ratio). You can capture, delete, name, save, and restore views. For 
example, you might want to capture a view while editing a complicated 
object in order to be able to switch quickly between views you have selected 
on opposite sides of the object. 


(R) or (L) to select from a list of previously saved views. (M) to save the 
current view. (c-L) or (c-R) to delete a previously saved view. 
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Align Submenu 


[Align] changes the orientation of the camera to align it with one of the 
global axes. When [Fixed-aim] is in effect, the camera swings around the 
aimpoint to align itself to the axis and so changes its position while 
remaining aimed at the fixed aimpoint. When [Fixed-aim] is turned off, the 
camera does not move but simply pans or tilts in place to get the new 
orientation. Since reorienting the camera changes the aimpoint, objects in 
the old view might disappear after the realignment. 


[Align] Points down the z axis, from the front. 
[Align (c-L)] Points down the z axis, from the back. 
[Align (M)] Points down the x axis, from the right. 
[Align (c-M)] Points down the x axis, from the left. 
[Align (R)] Points down the y axis, from the top. 
[Align (c-R)] Points down the y axis, from the bottom. 


Aim Submenu 


[Aim] sets the aimpoint of the camera. [Aim] displays a menu that lists 
the options for the camera’s aim; the options include all existing objects 
(listed at the bottom of the menu) and the following items: 


Aim at: 

Select element. 
Orient to element. 
Cursor 
Global Center 


Default Lights 


rolling—box 
box-8 
front—leg—left 
front—leg—right 
rear—-leg—left 
rear-leg-right 
contour—wire—Group 


[Select Element] Points the camera at the center of a selected 
vertex, keeping the current camera location 
constant. 


[Select Element (M)] Selects an edge for the aimpoint. 
[Select Element (R)] Selects a face for the aimpoint. 
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[Orient to Element] Points the camera directly at a vertex, that 
is, along the element’s normal, changing the 
camera position and orientation. 


7 | re 
[Orient to Element (M)] Orients the camera to an edge. 
[Orient to Element (R)] Orients the camera to a face. y 
[Cursor] — Moves a cursor around to choose a location for = 

the camera aim. i 
[Global] Aims the camera at the global origin (0,0,0). 7 
Existing Objects You can aim the camera at the center of an 


existing object or subobject. The existing 
objects are listed at the bottom of the menu. 
(L) to select an entire top-level object. 
Selection of an entire group is indicated 

on the menu by a solid black box around 
the group name. (R) to display a menu 

of the object’s inferiors for selection. 

(A gray box appears an inferior object to 
indicate only the inferior has been selected, 
not the entire group itself.) [Return] returns 
you to the previous menu. — 


La 


Level Submenu 


[Level] sets the rotation around the camera line-of-sight to zero, that is, it 
removes all camera roll, making the camera as upright as possible. 
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Creating and Transforming Objects 


| To add a new object, bring up the MAIN menu and use [Add New Object]. 
wi This brings up a menu with six ways to add a new object. 


.Overlays. 
.List. Objects. 

. Transform Object. 

-Modify Element. 

. Attributes, 


ine 
ir 
mee Reinstance 
be 
“ai [Get] Brings an object from the Lisp world into the 
ae S-Geometry environment. Since you normally create 
iE! and modify objects entirely within the S-Geometry 
environment, you probably do not need to select this 

phe menu item. See next page. 
1S 
£5 [Read] Reads an object that has been saved to file. See next 
en page. 
| il 
ae [Create] Creates a new object. See the sections "Creating 
ie Polyhedra from a Menu" and "Sketching Contours to 
ii Create Polyhedra" on pages 51 and 55, respectively. 
ie [Encode] Encodes a new object entirely from a tablet or mouse. 
iat See the section "Encoding" on page 80. 

[Copy] Creates a new object that is a copy of another object 
i but is physically discrete. See the section "Copying and 
ial Sharing Geometry Between Objects" on page 89. 
| [Reinstance] Creates a new object that shares the body of another 
iis object. Any change to the first object is automatically 
ce reflected in the new object. 
im 

43 

= 
= 


44 e S-Geometry 


Getting Objects 


[Get] is useful when you want to write programs to create polyhedra and other 
bodies. Once you have assigned a symbolic name to a complete body or object, 
use [Get] to bring up the following menu: 


Reading Objects 


[Read] reads in an object that has been saved to file. 


Read in New 3D-Object: 


Filenane : W:>crane>OBJECT .obj _ 


Ignore numbering: Yes No 


Read In Object =a 


Filenane : W:>malone>c*.obj.newest 

Wild files : Read All Gelect One Select Several 

Ignore nunbering: Yes No 

Read In Object (J 


Bae RI PE Oe 


Filename The pathname of the file to read. Filenames 
without extensions default to .obj, and the 
program notifies you when it cannot find a file 
with the name you supplied. 


If you specify ’*’ (asterisk) as a wildcard 
character in a filename, the [Wild Files] options 
are displayed. 


Wild files [Read All] reads all files that match the wildcard 
filename. [Select One] lists all possible files that 
match the wildcard specification and allows you 
to choose one. [Select Several] allows you to 


choose and load several files from this list. The 
default is [Read All]. 


Ignore numbering Determines whether or not to pay attention to the 
internal numbering within an object file. The 
internal numbering is sequential, starting at 1 for 
each type of element, and is provided to make it 
easier for you to read the text file. Internal 
numbering is usually ignored to speed up read-in, 
but it might be advisable to turn off [Ignore 
Numbering] when you have hand-modified or have 
otherwise altered a saved object because the 
numbers no longer correspond to the positions of 
the modified elements in the listing. 


ee 
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a i 
| = Objects can also be read in by a script. S-Geometry has built-in safe-guards 
al 1 to anticipate problems with reading in objects in this fashion. For example, 
| it is possible for two or more users to be modifying the same object at the 
—— same time on different machines. This leaves open the possibility that two 
versions of the same object might be saved out, one version not having the 
) changes made to the other. A similar problem occurs when an object is 
os WW moved to another directory but a script continues to reference the object by 
i a its old pathname. 
mn Mr You can set two global variables to deal with the possibility of such small 
| variations between the loaded and referenced objects. 
— Lj Typing (setq 3d:*reuse-existing-versions-of-objects) to a Lisp Listener 
| ensures that S-Geometry checks for variations in the pathname version 
os number. 
[| Typing (setq 3d:*reuse-similarly-named-objects*) ensures that S-Geometry 
ni Ly checks for objects that have the same filenames but different pathnames. 
l = If the version numbers are the same or the match of pathnames is exact, 
—— S-Geometry uses the loaded object as before. If they do vary, S-Geometry 
[| can do several things depending on the state of the two global variables. 
nn i 
= If either variable is set to :always, S-Geometry uses the loaded objects if the 
] relevant situation arises. If either is set to :never, S-Geometry always reads 
mn Or in a new copy of the object when the specified variation is detected. If they 
w have any other value (the default is :ask), a menu requesting whether to 
| reuse the existing object or read it in anew is presented. 
| ee 
| Clicking on the bottom line (in bold) causes the loaded object to be the one 
referenced in the script; moving off the menu causes a new copy of the 
| = object to be read in. 
nH When reading in an object with the read-in menu, the object requested will 
ez continue to always be read in, regardless of whether there are other copies 
] of the object already loaded. 
| an | 
= im 
Zz 18 
= 1 
= W@W 
= im 
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Creating Objects From a Menu 


Light sources, Bitstream fonts, and twelve types of polyhedra are created from 
the CREATE menu. Each object is created with its center at the origin. 


. tetrahedron. 
octahedron. 
. icosahedron. 


. cube. 
.cylinder. 
. sphere. 


.solid of rotation. 
. tube. 
.tube solid. 
. lamina. 
.contour solid. 


grid 
text 


Lights 


Lights, which are used for illuminating shaded or rendered objects, are 
created as objects in S-Geometry. Initially the view window contains a single 
default light source that is positioned at 100,300,150 (up and back) so that it 
illuminates all visible objects. 


All objects use the default light source for their illumination unless you 
create other lights or change the specification of the default light. Three 
light types are supported—point, ambient, and infinite. You can create a 
point and ambient light with default settings by clicking left and middle when 
you select [Light], respectively. To create an infinite light and to change the 
parameters of all light types, use [Light (R)] to bring up the following menu: 
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[Point] 


[Ambient] 


[Infinite] 


Nane 
Type 


Color 
Group 
Super 
Name 


Choose Parameters of New Light: 
: XLITE 


Space : Global Camera 
Strength : 1.6 


Make Light ( Abort [) 
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: Point Ambient infinite 


: 1.08 1.606 1.86 

: *DEFAULT-GROUPs 
jor : Default Lights 
mode: RGB IHS name 


A light type in which light radiates uniformly from 
a point. The default position is 0,0,0. 


A light type in which sourceless light is evenly 
distributed in all directions. An ambient light does 
not have position. 


A light type that is located at infinity and emits 
parallel light rays. It is specified by a direction. 
The default direction is 0,1,0. 


Point and infinite lights can be specified in global or camera space. 


[Global] 


[Camera] 


The coordinate system in which objects normally 
exist. 


The coordinate system centered with and aligned 
to the camera’s current view. Lights specified to 
be in camera space always maintain a constant 
relationship to the camera, even as it is moving. 
Camera space is left-handed (position z is forward). 


The following parameters apply to all light types. 


Strength 


Color 


The intensity of a light is greatest at 1 and 
decreases to 0. 


Allows you to set color values for RGB or IHS 
colormodels. If you have a color system, clicking 
to change the color values brings up the color 
palette on the color monitor. 


If you don’t have a color system, the menu lets you 
type in numeric values. RGB values range from 
0.0 through 1.0, with 0.0 representing minimum 
intensities. IHS values range from 0.0 to 1.732 for 
intensity and 0.0 to 1.0 for hue and saturation. 
Negative values are not allowed. 
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You can also type in the name of a primary or 
secondary color. 


Group Initial group in which the light is placed. Light 
groups are arbitrary, named collections of lights 
which are used by S-Render as an attribute. 
Lights can belong to any number of groups. See 
the section "Light Groups" on page 50 for 
information about managing light groups. See the 
manual S-Render for how lights and light groups 
affect surface characteristics. 


Superior Allows you to specify an object into which to place 
the newly created light. Once specified, this object 
becomes the default superior for other newly made 
lights. 

Name mode Colors can be specified according to the RGB or 


IHS color models. See the chapter "Color Models" 
in the document Color System for a detailed 
description of the components of the color models. 


When [Name] is enabled, the name of the primary 
and secondary color that the color values (IHS or 
RGB) most closely describe is displayed. You can 
type the color name into the Color parameter, in 
which case, the RGB color values are updated for 
that color. RGB and Name are interchangeable, 
only the display of Color is different. 


Lights are manipulated and their light properties specified through the 
[Modify Element] item of the MAIN menu. (Point lights can also be 
manipulated by selecting them in the view window and then clicking (M2).) 


Point Light 1: 
au : 


.Rotate. Brightness 
Set Direction Hue 
Brightness Saturation 
Brightness Hue Set Color 
Hue Saturation 
Saturation Set Color 
Set Color 


The first few menu items are common for all objects and are described in 
detail in the Chapter 5—"Manipulating Objects." 
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To bring up menus that accept numeric input, press the CONTROL key when 
using the mouse to select the menu item you want to modify. Interactively 
modifying the light properties can be done from [Shade] in the oUTPUT menu 
(this requires a color system). 


[Brightness] 


[Hue] 


[Saturation] 


[Set Color] 


[Set Direction] 


Controls the intensity of the color. 


Fhe color component that controls the frequency 
of the color. Hue is what most people think of 
as color. For example, blue and red are 
different hues. 


Measures the purity of a color. For example, 
pure blue has a high saturation. As saturation 
decreases, pure blue becomes a pastel blue 
before turning to a gray. 


Produces the following menu, which allows you 
to input numeric data for each light property. 
Note that lights have a brightness parameter 
that is separate from color. The separate 
brightness parameter scales the light values in 
the same way scaling the intensity does but 
allows you to edit dim lights and still be able to 
see the color. 


Color : 1.06 1.68 1.08 

Brightness : 1.8 

Scaled Color: 1.0@ 1.0@ 1.28 
Naming mode : AGB IHS name 


Set Light Color 0 Abort [ 


If you have a color system, clicking to change 
the color values brings up the color palette on 
the color monitor. If you don’t have a color 
system, you must type in numeric values. 


Accepts xyz coordinates for the direction of the 
infinite light. 


Because [Shade] in the OUTPUT menu shares the same lights with S-Render 
and uses the same gamma correction if S-Render is loaded into the 
environment, you can closely approximate what an object would look like if it 
were rendered with Lambert shading. 
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Light Groups 


Light groups are assigned from the menu that appears when you select 
[Render (R)] in the OUTPUT menu. 


“a 
Set Groups Lj HakeGroup [J ReadGroup J KillGroup CT] Abort CJ 


[Set Groups] Exits, accepting changes to the light group 
assignments. 


To add lights to a light group, click on the box 
that is across from the light and under the light 
group to which you want to assign the light and 
then use [SetGroup]. 


[MakeGroup] Creates a new group, prompting a name. 

[ReadGroup] Prompts for a pathname and reads in light groups 
(and any of its lights) associated with the file. 

[KillGroup] Deletes a group. 

[Abort] Exits, undoing any new associations between lights 


and light groups. Does not delete new groups. 


Lights can be in more than one group. 
Groups can be written to file by using [File] on the OUTPUT menu. 


Note: When you have several groups, you might want to abbreviate the 
names of the light groups so that all fit comfortably on the group menu. You 
do this by setting the global variable *light group attribute-mode’*. 


Type (setq xlight group attribute-modex :no-vowels) to abbreviate the group 
name by deleting all vowels. 


Type (setq xlight group attribute-modex :<a number>) to abbreviate the 
group name by truncating the letters at the end of the word. Whatever 
number you supplied for a number is the number of letters that is left at the 
beginning of the word. 


You can also set the variable to :nv-<a number>, which is a combination of 
deleting vowels and truncating the word. 
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Creating Polyhedra from a Menu 


Tetrahedra, octahedra, icosahedra, cubes, cylinders, spheres, and grids with 
default settings can be created by a single left mouse click. The default 
values for each polyhedron are shown in the menus in this section. 


To change the default values, (R) to bring up a menu that allows you to 
specify parameter values. Parameter settings for the polyhedra parameters 
menus are described in the section "Parameter Descriptions for Polyhedra." | 


The menu items that describe the menu-created polyhedron are accurate only 
for the polyhedron that is created with the default settings. For example, 
both objects in the following figure were created from the cylinder menu. 
The object on the right is a cylinder created by using the default settings. 
The object on the left was also created from the cylinder menu except that is 
has 3 (rather than 36) faces around and it has a wedge cut. 


Figure 4.1 Modified cylinder and cylinder with default settings 


Simply modifying the polyhedron default settings is often an overlooked 


method for creating interesting polyhedra. 


[Grid] 


The grid is a type of closed, infinitely 
thin, rectangular polyhedron with one 
large backface and a front side sub- 
divided into an array of faces. 


Select Grid Parameters 

Object name : GRID : 
Width (x) : 108.8 q 
Height (y) : 108.6 
Faces across : 18 

Faces down Le . 
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[Tetrahedron] 


Select Tetrahedron Params 
Object name: XTETRAHEDRON 
"Radius" : 18.8 


Make Tet Abort [ 


[Octahedron] 


Object name: XOCTAHEDRON 


"Radius" : 18.6 
[Icosahedron] 


Select icosahedron Params 


Object name: XICOSAHEDRON 
“Radius” : 18.6 
Make Icos {() Abort () 


a 
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[Cube] : 


Object name: XCUBE 
Width (x) : 28.@ 
Height (y) : 28.8 
Depth (z) : 20.8 


Make Cube [J Abort [7 
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[Cylinder] 


Se Cylinder Parameters sss 
Object nane : CYLINDER 

Radius : 16.8 

Height : 20.8 

Swept angle : 368. 


5 


Faces around : 36 
Major axis TaN, 
Wedge-cut : Yes No 
Pie-cut poles : 


is 


(3) 


[Sphere] 


Object nane 

Radius : 18.8 

Swept angle : 368.8 
— n-Latitudes : 18 
TA n-Longitudes ;: 36 
= Polar axis 2 ¥ 

Wedge-cut : Yes No 

Pie-cut poles : Yes No 


Make Sphere L Abort (1 
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Sketching Contours to Create Polyhedra 


Solids of rotation, tubes, tube-solids, laminas, and contour solids are created 
by sketching one or more characteristic outlines in 2D and combining them 
in several ways to make a 3D solid. These outlines are usually referred to 
in S-Geometry by more specialized terms that describe different types of 
curves. Free-floating curves in space are called paths and are typically 
used as the guiding shape for tubes. Outlines used in conjunction with, 
and parallel to, a reference axis are called contours. For example, the 
curve giving the characteristic shape to a solid of rotation is a contour. — 
Outlines that are used perpendicular to an axis or path are called cross 
sections. These are also typically closed or almost closed curves and are 
drawn in relation to an origin point, used as reference when combining 
these outlines. 


Sketching is a type of encoding that simply describes a path on the surface 
of the screen. A sketched curve only lasts for the duration of the sketching 
session and is not an official geometric entity. However, at the end of the 
sketching session you can convert a path into wire, which is a geobody. 


With the exception of laminas, which are flat and require only one outline, 
all the other polyhedra are built up by combining two curves. Sometimes 
you need to supply only a single curve since the other one has a default 

_ shape, typically a circle. A solid of rotation, for example, is really just a 
special case of contour solid that has a circular cross. section centered at 
the origin. Tubes require you to supply a path, but you can let the cross 
section default to a circle if you wish. Contour solids and tube solids 
require you to supply two outlines. 


From the MAIN menu select [Add New Object] and then [Create]; this gives 
you a selection of solid types to make. All the composite types give you the 
option of sketching a new path or using an existing wire as the path. This 
is true for both the contour or path, and the cross section. Click (R) when 
selecting the polyhedron type to use an existing wire or to encode a new 
wire in 3D to use as the contour. Click (L) to sketch a new path. This 
brings up a worksheet, which is a grid over which you sketch. (You can 
skip the worksheet setup and use the previous worksheet parameters by 
clicking (M) when selecting the solid type.) 3 
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(5) 


Center (x) 
(y) 
Grid spacing 


Worksheet width: 71 
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Tick spacing : 2.8 
Tick length 6 
Mouse grid (x) : none 
(y) : none 
(angle) : none 


[Worksheet Width] 


[Center] 


[Grid Spacing] 


[Tick Spacing] 


[Tick Length] 


[Mouse Grid] 


The distance from the left side of the view 
window to the right. Units are always the 
current global units, and the drawing surface 
is always on the x-y plane. Make sure the 
worksheet is big enough to encompass the 
ultimate size of your object, although you can 
resize the worksheet during sketching if 
necessary. (Initially, the size defaults to one 
that approximates your current view.) 


The location (x,y,0) which is at the center of 
the screen. x and y default to 0. 


The interval, in global units starting at zero, 
at which horizontal and vertical grid lines are 
drawn across the screen. 


The interval at which short tick marks are 
drawn across the top and left edges of the 
sketch worksheet. These are useful for 
reference, since two cursors along the edges 
follow the position of the mouse as you move 
it on the worksheet. 


The length of these tick marks, in pixels. 


The mouse grid allows you to constrain the 
mouse to stop only at specified intervals. For 
example, if 0.1 is entered as the (x) value, the 
mouse moves in increments of one tenth of a 
global unit along the x axis. Any points you 
encode, therefore, have x-coordinates that are 
exact multiples of 0.1. If 15 is entered as the 
(angle) value, the mouse is restricted to move 
only in 15-degree increments from the last 
encoded point, so all your segments will have 
slopes with exact multiples of 15 degrees. 
Specification of a mouse grid on the sketching 
worksheet is useful when you want to line up 
elements in the sketched contour. 
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You might wonder what would happen if all 
three values were set, since it would seem 
that the mouse could be overconstrained. 
Indeed, it is possible that for many values of 
(x) (y) and (angle) there is no point on the 
worksheet besides 0,0 to which the mouse can 
go. Because of this, S-Geometry ignores the 
(angle) constraint when both (x) and (y) are 
set. 


How to Sketch 


Once in the sketch editor, click (L) to start the contour. A contour element 
can be either a straight line segment or an arc. Straight lines are created 
simply by dragging the mouse to a new position and clicking (L). Curved 
segments of a contour are created in three steps. First, click (M) to tell 
the sketch editor you want to start an arc. Then drag the mouse to control 
the size and position of the circle and click (L) to establish its center. 
Finally, drag the mouse out to the perimeter of. the circle and click where 
you want the arc to end. You will notice that the whole circle is left on 
the screen—by default the portion of the circle used is the shorter of the 
two arcs, but if you make a wire from the contour this can be converted to 
the longer arc (see [Flip Path]). 


The radial lines to and from the center point are also left on the screen. If 
the next line segment of the contour is to blend smoothly with the arc (be 
tangent to it), you can use the radial lines as a guide: position the far 
point of the segment so that the radial line and the segment are at right 
angles. Using the mouse grid angle constraint can be helpful here. 


Figure 4.2 Sketch showing straight line coming off arc 
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Similarly, you can make an arc blend smoothly with another arc by 
ensuring that the radial lines of the two arcs are colinear: after cutting 
the first arc, click (M) to start another arc, drag the mouse back over the 
first arc’s radial line, then click (L) to place the center of the second arc 
on the same line. Again, using the angle constraint here can be helpful. 


I 1 \\s 
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Figure 4.3 Sketch showing two arcs on same tangent 


Because S-Geometry automatically fills the gap between the first and last 
wt points when converting your contour to a polyhedron, it is important not to 
re-encode the first point when making an enclosed shape, as for laminas or 
a cross sections, or to place the first or last points on the major axis, for 

i solids of rotation or contour-solids. 


1 The Importance of the Origin 


a For polyhedra made by the interaction of two contours, the position of each 
DK contour with respect to the origin affects the final shape of the solid. 
Laminas are the only sketched polyhedra that don’t particularly care where 
ia its source contour is located. For solids of rotation and contour solids, the 
it distance of the side contour from the major axis becomes the radius of each 
section, and so affects the overall volume of the solid. For tubes, tube 

= solids, and contour solids, the origin is the point which is dragged along 

— the path (tubes, tube solids) or major axis (contour solids). The volume of 
the solid is displaced from the path or major axis to the same extent that 
the cross section is displaced from the origin. 


Figure 4.4 shows the effect of displacing a side contour from the major 
— axis. 
i 
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Figure 4.4 At top, diagram showing two contours 
placed at different distances from origin. 
At bottom, the resulting contour solids. 


When creating cross sections for tubes, the placement of the cross section 
relative to the origin determines how the cross section follows the path of 
the tube. The point (0,0) on the cross section follows the path exactly. 


i 


If the origin is inside the cross section, the resulting volume completely 
encases the axis or path it is following. If it is on the cross section, the 
axis or path will lie on the surface. And finally, if is outside, the solid will 
be in the vicinity of the path, but won’t actually touch it. In the following 
example of a tube, the cross section is created along the y axis of the 
origin. This displacement of the cross section offsets the resulting tube. 
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Figure 4.6 Tube created with cross section positioned on origin 


When creating cross sections for contour solids, the axis of the contour 
ik solid will pass through (0,0) of the cross section, so for most purposes the 
cross section should be placed so that the origin is interior to it. If the 
origin is outside the cross section, the entire volume of the contour solid 
will be offset to one side of the axis. 


Note that for contour solids the absolute size of the sketched path of a 
cross section does not matter since it is the distance between the contour 
path and the axis that determines the final size of the cross section. 
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Figure 4.7 Ai top, diagram showing two cross sections 
placed at distances from origin. 
At bottom, the resulting polyhedra 
Ending Sketching Session 


Do not connect the last to the first point. S-Geometry automatically does 


this. 
When you (R) to end the sketching session, you are given the following 
options: 
.KEdO. 
Continue 
Wire Only 
Ok 
Ok, Wire too 
Abort 
[Redo] Starts the contour from scratch. 
[Continue] Allows you to continue sketching the 
contour. 
[Wire Only] Gives you the opportunity to save your 


contour as an object in itself, which can be 
subsequently edited and used to make other 
objects, then exits sketching. 
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[Ok] Exits, using the contour to make the object. 

[Ok, Wire too] Makes both the object and the wire. 

[Abort] Exits sketching without making an object 
and throws away any contour you might have 
made. 

Sketching Session 


This exercise gives step-by-step instructions for constructing a table that 
has contour solids for its legs and a tube solid for its top 


Table leg 
1. Sketch the contour for the table leg. 


pea EH fae Der Cenc ada ol! oni 
So i es MS 
epee tne renew fer 
pa Irae behind 
for Eat coke ord oe eed eet ee. 
sisi aks ee Oa Ee ad ta 


Since the worksheet units are always the current global units, 
the height of the path corresponds to how high the solid will be 
in the view window. 


When you (R) to end the sketching session, choose [Wire Only]. 
Having a wire allows you to further edit the shape of the contour. 
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2. Create a splined wire. 


Select the wire and use [New Spline] in the MODIFYELEMENT menu. This 
picture shows the original wire with its spline. 


3. Create the cross section for the table leg. 


Sketch a wire in the general shape shown here. For the cross 
section, the size of the sketched path does not matter since it is the 
distance between contour path and the origin that determines the 
final size of the cross section. Notice that the cross section is 
sketched entirely to one side of the center axis. 


Use [Wire Only] when exiting the sketching session. 
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mil | : 
= Once the path :s sketched, use [New Spline]. 
a : 
mi } 
a. 
m a 
m we The little indentations of the splined cross section were put in 
| , by hand to give more variation to the shape. 
: a Once the contour and cross section have been sketched, create 
| the table leg. 
m it 
| Object nane ; i rauleateas 
mrt Sito it | em ee eon 
_- Arb c.s. fron : New wire Previous wire 
| C.S. object : Splined leg cs 
C-S init rot. : @ 

oA Toroidal? : Yes No 
b | ‘k Sian ogg te ee No 
| Make Solid [ 
m Ks 
m it 
| : 4. Create the path for the table top. 
m AG 
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j hacia : 
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m YK 
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All paths are created on the x-y plane. Since you probably want 
the table top to lie on the x-z plane, rotate the wire once it’s 
created. Use [Bake This] after the rotation to make the new 
position the wire’s home position. 


5. Create the contour for the table top. 


Since the contour is not very big, you might want to resize 
the worksheet. 


Once the path and contour have been sketched, create the table top. 


Select Tube Solid Parameters 
Ob ject nane : table-top 
Path Object : Splined leg contour 


Arb c.s. from : New wire Previous wire 
C.S. object : Splined leg cs 

C.5. init rot.: @ 

Pie-cut poles?: Yes No 


Make lube Solid U 


g. Arrange the pieces into a table. 


A few hints. Use [Reinstance] to make three additional legs. 

Rotate the legs before moving them away from the home position. 
Rotations of 45, 135, 225, and 315 should give a nice angle to the 
table legs. Move the legs along the major axes to their new positions. 


If you need to start the positioning over, use [Initialize], which puts 
the legs back at their home position. 
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[Solid of Rotation] 


A solid of rotation is an object created by encoding the contour of the 
object from top to bottom. The silhouette is then swept around either the 
vertical or horizontal axis to create an object according to the menu shown 
below. Note: In order that the solid of rotation does not intersect itself, 
the contour must lie entirely to one side of the axis of rotation. 


Select Solid-of-Rotation Parameters 
Object name : ROTSOLID 
Sketch axis Rave eee ei Se ee ROC ger omens pee ae 3 oS — 
Toroidal : Yes No 
Wedge-cut : Yes No 
Swept angle : 360.8 
n-Longitudes : 36 
Polar axis aay 
Pie-cut poles : Yes No 


Make Solid | Abort 
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[Tube] 


A tube is a polyhedron created by sweeping a cross section along a path 
defined by a wire or sketched contour. The cross section can be 
automatically generated, radially symmetric (circular), drawn by hand, or 
derived from a preexisting wire. 


Select Tube Parameters 


Object name : TUBE 

Cross Section : Circular Arbitrary 
Radius Sh Looe 

n-Divisions : 18 

C-S init rot. : @ 


Ring? : Yes No 
Pie-cut poles?: Yes No 


Object name 
Path : sketched 

Cross Section : Circular Arbitrary 

Arb c.s. from : New wire Previous wire 


: @ 
: Yes No 
: Yes No 


C-S init rot. 
Ring? 
Pie-cut poles? 


[Circular] automatically generates a cross section. [Arbitrary] gives you the 
option of sketching a cross section or using a previously created wire as the 
cross section. 


Note: Pie-cut poles for tubes is not implemented in this release. 


Figure 4.8 Right, a wire and a tube with a circular cross 
section made from it 
Left, a multisegmented wire and a tube made from 
it with an arbitrary cross section 


68 e S-Geometry 


9 How the contour and cross section combine 
to form a tube 


Figure 4. 


Figure 4.10 The finished contour solid 
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[Lamina] 


Wai 


[Lamina] sketches a contour, which is then made into a flat, double-sided 
polyhedron. 


la WwW WwW Ww 


Um 


Figure 4.11 Sketch, finished lamina, and extruded lamina 
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[Tube Solid] 


A tube solid resembles a tube in that a contour is swept along a path, but 
instead of the contour being closed (creating a cross section), the whole 
swept area is enclosed by connecting the beginning and end of the path and 
creating top and bottom faces, like a contour solid. The path should lie on 
a single plane, otherwise the top and bottom faces of the tube solid become 
twisted. 


~ s TSOLID 
Path Object : tube-solid-wire 


Arb c.s. from : New wire Previous wire 


C.S. init rot.: @ 
Pie-cut poles?: Yes No 
Arc Sampling : 18.8 
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Figure 4.12 How the contour and cross section combine 
to form a tube solid 


| 


Figure 4.13 A finished tube solid 
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[Contour Solid] 


A contour solid is a polyhedron created by scaling the cross section out to 
the contour. 


Select Contour Solid Parameters: 


Object nane : WCSOLID 
Contour Objct : Splined leg contour 


Contour axis : xX ¥ 

Aeiic.c. 2COR: 1 New whe Pravieus! wire ig ERS ae a con eM eee dome ree I laa ee 
C.S. object : Splined leg cs 

C-S init rot. : @ 

Toroidal? : Yes No 


Polar axis 


say, 
Pie-cut poles?: Yes No 
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os Figure 4.14 How the contour and cross section combine 
to form a contour solid 


Figure 4.15 Finished contour solid 
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Parameter Descriptions for Polyhedra 


The following menu items, which are ordered alphabetically, are specified 
for polyhedra that don’t have to be encoded. Not all menu items pertain to 
all polyhedra. 


Are sampling Appears on the menu only when the contour 
contains an arc. It specifies, in degrees, 
the frequency to be used for sampling the 
arc. The greater the number entered, the 
less frequent the sampling and the fewer 
facets on the arc. 


C-S init rot. Specifies the initial rotation, from the 
home position, of the object’s cross section. 

Depth Distance along the z axis. 

Faces around Specifies how many faces the cylinder has. 

Height Distance along the y axis. 

Major axis The axis around which the center of the 


cylinder is aligned. Possible values are 

the symbols x, y, or z, or a list representing 
a Cartesian vector; for example, (0 1 0) is 
equivalent to the y axis. 


n-Latitudes Specifies the number of faces between the 
poles of the sphere. 


n-Longitudes Specifies the number of faces around the 
sphere or solid of rotation. 


Pie-cut poles Specifies whether the top and bottom of 
the object are to be circular faces or 
are to be formed by connecting the faces 
to a point at the pole (thus forming a pie- 
shaped form). The default is No. In the 
following figure, the cylinder on the left 
is the default cylinder; the one on the right 
has pie-cut poles. 
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| Figure 4.17 Default cylinder and pie-cut cylinder 
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—_ Polar axis The axis along which the center (pole) of 
the object is aligned. The default is y, along 
the y axis. The possible values are x, y, z, 
or a list of vector components and an axis. 


15 If you want an object with vertical axes, encode 
the contour top to bottom and specify y as the 
polar axis. If you want an object with a horizontal 
1: axis, encode the contour from right to left and 
specify x as the polar axis. 


re Radius The distance from the center of the polyhedron 
| to each of its vertices. 


‘E Ring? Connects the first and last sections. The 
| default is No. Note: Unless the path of the 
tube lies entirely in one plane, it is virtually 


a guaranteed that the faces of this last section 
will be twisted. 3 

= Sketch axis Specifies the axis around which the contour 
is assumed to rotate. S-Geometry determines 

rt the default axis based on the shape of your 

= contour. 

7 Swept angle Specifies the degrees that the polyhedron is to 

— be created. 360 degrees is a complete sphere. 


180 degrees indicates one half of a sphere. 
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Toroidal 


Wedge-cut 


Width 


Specifies how the object is finished. If the 
object is toroidal, its top and bottom are 
connected and a “tunnel” is formed through 
the object. If the object is not toroidal, its top 
and bottom are finished with flat planes. 


os 
CSAS 


Figure 4.18 Left, nontoroidal solid of rotation 
Right, toroidal solid of rotation 


A swept angle of less than 360 degrees 

the object with an open end. The 

default treatment is to close the open 

end with a flat polygon for each latitude 
line. When wedge-cut is enabled, a spine is 
created down the center of the object and 
two planes are created to connect the edges 
to the center, creating the wedge shape. 
When wedge-cut is selected, pie-cut poles 
are created. See figure 4.19. 


Distance along the x axis. 
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Figure 4.19 Two 270-degree swept-cut cylinders: 
default and wedge-cut 


rt 
gt Text 
' i Any Bitstream font can be loaded into S-Geometry as.a 3D object. The 
. fonts shown here are available in S-Geometry if you have S-Paint 
loaded. 
Swiss 742 
iE Swiss Slabserif 722 Serifa 
ae Swiss 721 Bold 
Swiss 721 


Square 721 Extended 


Revival 710 Bookman/Head 
= Modern 721 Poster Bodeni/Mend| 


Geometric 211 Futura Bold | 


Selecting [Text] brings up the following menu: 


Object name : x 
Character(s) : Sample 


Font : Swiss #42 
Font Height : 18.8 

Kern chars? : Yes No 
Ltr-spacing2 : @.6 
Make Characters (J 


y, “= 
(mf 


iz 

WE [Characters] Accepts any text string; the characters that can | 
‘ be entered are shown in figure 4.20. Each 

'u Bitstream character is a separate body and is 


inferior to the top-level text object. 
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[Font] Any Bitstream font that you have can be loaded 
into S-Geometry. S-Geometry itself does not 
distribute Bitstream fonts but instead uses those 
supplied with S-Paint. The default font is the 
first available loaded font, if any. 


Select 3D Text Parameters 
Object name : TEXT 


Cheracter(s) : Samp 
q 
Font : Suisse New | 


Font Height : 18.6 
Kern chars? : Yes ! 
Ltr-spacing2 : 6.8 
Make Characters UL ts ero 2 eee 


Using [New] allows you to read a font off disk. 
Fonts that are not loaded by S-Paint are located 
in the directory sys;bitstream;fonts;. 


[Kerning] | Compensates for wide and narrow characters by 
| setting extra space around wide characters and 
setting less space around narrow characters. 


[Ltr Spacing] Controls the amount of space between all 
| characters. 


When you want to transform an entire character string, you must use 
the [Transform Object] menu since a character string is made up of 
several bodies. 


Bitstream font characters are created as laminas and can be 
manipulated just like any other object. However, the number of 
operations you can use with general faces (faces with holes) is limited 
(see the section "General Faces" on page 108). 


This keyboard shows what symbols and accents are supported when you 
type text into the text parameter menu. The symbols shown in the 
bottom right corner of the key are obtained by pressing SYMBOLwhen 
selecting the standard key (the standard uppercase character is shown 
on the left). The symbol in the upper right is obtained by pressing 
SYMBOL SHIFT and the standard key. 
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Figure 4.20 Keyboard assignments for Bitstream symbols and accents 
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Encoding 


Objects can be created by manually specifying (encoding) the coordinates of 
all its elements in such a way they fit together in a manner appropriate for | 
the type, of body you want. Two types of geobodies can be encoded: the 
polyhedron and wire. You can use the tablet or mouse to encode objects, or 
you can switch between the two. Hand-encoding a polyhedron by defining the 
vertices of each of its face polygons is fairly laborious but useful when you 
have blueprints or sketches you want translated into a 3D object. Wires are 
useful for defining the path of tubes. 


When encoding polyhedra, you are responsible for maintaining the integrity of 
the database. Keep these two main rules in mind: 


1. You must create polygons in a clockwise direction, looking toward the 
"out" side of each polyhedron. 


2. You must ensure that an edge is shared by exactly two faces. 
When encoding, mouse clicks result in the following actions: 
(L) Creates a new point. 
(L2) or (sh-L) Connects a line to the nearest old point, which 
is highlighted. You must (L2) to adjoin faces, 
otherwise an invalid polyhedron consisting of 


floating polygons results. 


(c-L) Undoes the last segment in the face. If the last 


point was not shared by other faces, it is 
deleted. 


(M)-Hold Adjusts the location of the cursor in the z axis. 


e 
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(R) Closes the current face by creating an edge 
between the last and first vertices. 


im 


ig (R2) or (sh-R) Displays the ENCODING OPTIONS menu. 

| 

(c-R) Halts encoding temporarily to let you execute 
one S-Geometry command before returning to 
encoding. This is useful for moving the location 
of the camera. 


im 
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a 

When you are finished encoding a polyhedron, use [Bless] on the polyhedron 
ia operation menu to determine whether the polyhedron is topologically valid. 
iw 
= Mesh Mode 
if Mesh mode allows you to encode a mesh of faces in a polyhedron in fewer 


steps because you need encode each point only once. Instead of encoding 
faces individually, you can encode rows of points and S-Geometry creates 
faces between the rows, connecting the first edge in each row with the 
corresponding edge in the next. 


: 
t - . ] - 


To use mesh mode, encode a polyhedron as you would normally except that 
instead of using (R) to close a face, use (m-R) (that is, depress the META key 
ie while pressing the right mouse button). This ends the rows of edges and 
allows you to start another. On the second and subsequent rows when you 
use (m-R), S-Geometry automatically creates quadrilateral faces, with the 

— necessary connecting edges, between the corresponding elements on the 
encoded rows of edges. 


If the rows are of different length, the number of new faces is determined by 
the number of points in the shorter row. 
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To ensure that faces within a mesh are clockwise from the direction you are 
looking at them, set points in a row so that they go from top to bottom, and 
place rows from left to right. Any orientation that preserves this relationship 
results in clockwise faces. 


ae 
BS 


Note: While using mesh mode, you should not use (L2) to connect to existing 
points in the polyhedron. The mesh must be created in isolation and any 
connections must be made by encoding faces individually. 


Encoding Options 


To display the following menu of encoding options, (R2) while encoding. (This 
menu comes up only you have entered the encoding process by selecting 
[Encode].) 


ui 
Temporary Halt 
. Zero. 


- 


i i 


i i ih Oh Oh Oh Oro 
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[Calibrate Tablet] Produces a menu that allows you to set up the 
tablet for encoding. See the section "Tablet 
Calibration" on page 85. Appears only when the 
tablet software is loaded. 


[Cursor] Modifies the cursor parameters. 
[Tablet Input] Specifies that encoding input should come from 
the tablet. 
[Quit] .- Ends the encoding session and returns to the 
top level of S-Geometry. 
[Temporary Halt] Halts encoding for one command. 
[Zero] Resets the cursor position to x=0. 
[Zero (M)] Resets the cursor to y=0. 
[Zero (R)] Resets the cursor to z=0. 


Modify Cursor Parameters 


Use [Cursor] in the ENCODING OPTIONS menu to change the shape and _ 
characteristics of the cursor that is used during encoding. The two kinds of 
encoding cursors are crosshair and locator box. 


Cursor Type : Crosshair Locator-box 
Crosshair Len : 

Crosshair Gap : @.@ 5 

Cursor speed : 1.8 

Set rsor Parameters ( Abort 


The crosshair cursor consists of three intersecting lines. | When crosshair 
is enabled, you can set the speed of the cursor, control the length of 
the crosshairs, and specify the gap between the positive and negative arms. 


The locator box cursor shows where the cursor is in three space by drawing a 
box to connect the cursor with the x, y, and z axes. You can set the overlap 
length, analogous to the crosshair length, and the box style. Locator boxes 
are of three types: 
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[3-arm] > 


Draws a line from the cursor 


to the intersection of each of 
the three planes. | 


[Half-Box] 


Draws a line from the cursor 
to the intersection of the ie 


three planes and then draws a 
line from the intersection to tf 
the coordinate axes. When the 


axes are displayed, [Half-Box] 
resembles [Full-Box]. 


[Full-Box] 


Resembles [Half-Box], except that 
a final line is drawn from the 
coordinate axes to the origin. 


{ 
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Using the Tablet 


The tablet is available for sketching 2D contours when making composite 
polyhedra such as solids of rotation or contour solids and for encoding directly 
in 3D. The first mode is reached, starting on the MAIN menu, via [Add New 
Object / Create / <polyhedron type>] and the second via [Add New Object / 
Encode]. You can enable the tablet for use only after you have entered one of 
these modes. To do this click (R2) to invoke the ENCODING OPTIONS menu. Use 
[Tablet Input] to enable the tablet: 


Encoding Opti = 
Tablet Input 


uit 
Temporary Halt 
Zero. 


ial 


Tablet Calibration 


Once the tablet is enabled, it should be calibrated to match either the size of 
the sketching worksheet or the scale of the artwork being encoded. The first 
case is pretty straightforward since you are matching the 2D tablet surface 
with the 2D worksheet. The second case, encoding directly in 3D, is more 
complex. 


Va 


In order to encode a solid shape it is necessary to have a sufficiently detailed 
drawing of the shape with two good views from two different sides, and which 
line up along one dimension. One view is considered the primary view and is 
the drawing from which two of the three coordinates are derived. The second 
is the secondary view, from which the remaining coordinate is read. Although 
the secondary view is required only to display one coordinate, it should 
nevertheless be reasonably detailed so that it is easy to see the correspon- 
dence between points in the two views. 


im 
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The whole drawing (both views) should be able to fit on the active area of 
your tablet. The drawing can be set up in many different ways, but, because 
of the shape of most tablets, it is usually most efficient to have the two 
drawings side by side. The following example assumes that you have a front 
view, which is the primary view, and a secondary side view. 


(ig. 


Your drawing should look something like the following: 


Ug) 
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Side View (z) | Front View (x, 


Reference Point #1: -20.5, 0.0, -16.5 
Reference Point #2: 25.0, 0.0 


Note that it is not important which side the side view is on, but the positive 
depth direction on the secondary view should be aligned with the positive 
direction on the tablet (that is, to the right or upward). Here, the depth 
direction is z, and since you probably want the front of the house facing 
toward you (positive z), in the side view the front of the house should be 
facing toward the positive (right) side of the tablet. 


Detail on the back should be visible from the front view, and detail on the 
sides should be marked on the edges of the front view. 


The drawing should also be marked with an origin and at least one other 
point, usually on one of the major axes, to indicate scale. It is best, as in this 
drawing, to have two points (labeled Reference Points #1 and #2) at the 
extremes of the drawing. It is not necessary that they be on a horizontal 
line, but they are usually easier to deal with that way. It is also most 
convenient to select distances from the origin which are some integral 
number. The unit of measure should be in the current world units. 


For this house, the origin is located at the front left corner at ground level. 


Before beginning to encode, tape your drawing to the tablet so that all points 
on the drawing are inside the active area of the tablet. 
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To invoke tablet calibration, (R2) while in the encoding process to display 
ENCODING OPTIONS, then use [Calibrate Tablet]. The following calibration 


| window appears: 
m Os TABLET CALIBRATION 
7 (Creating new tablet interface) 
Ueaahuet eo cate Se ote eh che tablet surface 
tl representing two Seite on one of the major planes 
(X-¥, K-2, or Y-2) 
Which major plane does the tablet surface represent (default: K-Y)? 
| Tablet-direction of depth: (H or V) (default: H) + 
BO tl Encode reference point 1: ( 2761, 2383) 
- Encode reference point 2: ( 12948, 2691 ) 
| Enter coordinates of first point: x y z + -18 -18 @ 
Enter coordinates of second point: x y * #18 -1@ @ 
m ie 
- Scale : @.@6206 
Origin : 7696 7626 2682 
| Degrees: 1.7991 
7 la *Click to continuesff 
| <a Calibration Window 
| 1m Puck or Stylus? (P or S) 
= Specifies whether a puck or stylus pen is to be used. For S-Geometry, a puck 
= 5 : 45 : ; 
-- is recommended both because it is easier to locate points exactly on a drawing 
I and because pucks typically have several buttons, which makes it easier to use 
= i S-Geometry’s encoding functions without resorting to the buttons on the 
i es mouse. 
Fe Which major plane does the tablet surface represent? 
i —— Press RETURN if you want to use the x-y plane (default). You should do this 
—_—_ when sketching contours, since many operations done from the sketch editor 
! assume the contours are in the x-y plane. 
= i sree 
is: If you are encoding directly to 3D, the answer to this depends on which major 
[! a plane the primary view of your drawing represents. In the house example, it 
= re is a front view, or x-y, the default. If it were a different plane, you would 
li fi; type in either x-z or y-z and press RETURN. 
Be rt Tablet-direction of depth: (H or V) 
] = This is applicable only to direct-to-3D encoding. If you are encoding in 2D 
i -- (sketching contours), simply press RETURN. 
= 5 Tablet direction of depth specifies a horizontal (default) or vertical depth 
aa direction for your second view. The reference baseline that you set up by 
3 specifying two reference points determines the horizontal and vertical 
m ra directions. This represents the change in your third coordinate axis, for 
if example, z. 
m fl 
mul 
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If you are using a side view as your second view, the tablet’s depth direction 
is horizontal. If you are using a plan (top) view for your second view, the 
tablet’s depth direction is vertical. 


Encode reference point 1: ( ; ) 
Before beginning, be sure your drawing is firmly affixed to the tablet. 


This is the first of two reference points that represent the extremes of the 
drawing and must be specified so the tablet has the reference coordinates for 
encoding the object. The two points allow S-Geometry to calculate the angle 
of tilt of the drawing if the drawing is crooked on the tablet. They should be 
fairly far apart on the drawing to ensure accurate calibration. 


Position the pen or puck over the first reference point. Note that as you 
move the pen around over the tablet, the position of the pen in absolute tablet 
coordinates is continuously updated. (L) to encode the point. The tablet 
coordinates of the point are displayed. 


Encode reference point 2: ( 2 ) 
Repeat for the second reference point on the opposite edge of your drawing. 
Enter coordinates of first point: x y z 


Type in the x, y, and z coordinates of the first reference point. Note that this 
is really a composite coordinate. The x and y coordinates (or whichever 
belong to the primary view) are measured from the origin of the primary 
view. The remaining coordinate is measured from the origin of the secondary 
view. In our example, the z coordinate of the reference point at the back side 
of the house is -16.5. However, the origin of the side view (the front surface 
of the house) is 4.0 units to the left of the origin of the primary view (0,0). 
Thus the x coordinate of the reference point is -16.5 - 4.0 = -20.5. The 
coordinates of the first reference point are thus -20.5 0 -16.5. 


Enter coordinates of second point: x y 


Repeat for the second reference point. Because the scale for the secondary 
view is assumed to be identical to that of the primary view, the depth 
coordinate is ignored. Our second reference point is at ground level 25 units 
to the right of the origin, so the coordinates are 25 0. 


When you have completed this entry, the calibration window reports the scale 
of the drawing to four decimal places, the origin of your drawing (in tablet 
coordinates), and the number of degrees the drawing is tilted relative to the 
tablet. Click on a mouse button to exit the calibration menu. 


| 
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Verifying a Polyhedron’s Validity 


|e) 


After a polyhedron has been encoded, use [Bless] from the polyhedron menu to 
verify that the polyhedron is valid. You can also bless a polyhedron by typing 
to a Lisp Listener (send J :bless). 


t=) 


If everything is correct, a response similar to the following appears: 


is. 


---- #<POLYHEDRON 1> ----- 

All vertex-edge-ptrs exist and refer to proper vertices. 
All face-edge-ptrs exist and refer to the proper faces. 
All edges have reciprocally pointing wings and share the 
proper faces. 

- 


(mm 


i 


Database errors are listed if any are found. Some minor problems, such as an 
element’s missing pointer, are corrected if other references to the element are 
located. 


ry 


Copying and Sharing Geomeiry Between Objects 


im 


You can duplicate an object by using [Copy] or [Reinstance]. 


[Copy] physically copies the geometry of an object, creating a discrete new 
object. You can also copy an object’s geometry by using the polyhedron 
modification menu. 


a 


[Reinstance] creates a new object that shares the body of the polyhedron 
that is instanced. Any modification to the geometry of that polyhedron is 
reflected in all instances. If the polyhedron is rotated or moved, all objects 
instanced from that polyhedron are also rotated or moved. To change an 
object without modifying all instances, use [Transform Object]. 


i? 


i 


a The two effects are visually identical; unless you modify one of the bodies, 
it is not easy to tell which operation was used. Figure 4.21 shows a cube 
that was copied once and reinstanced once. Only the reinstanced cube 
reflects the modification to the original. 
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Copied Reinstanced 


Figure 4.21 Copied and reinstanced cubes 


Transforming Objects 


Transform | 
-Modify E) 
Attributes. 


.Axis Scale. 
-Local Shear. 


An object’s appearance or location can be modified by changing the 
object’s transformation matrix rather than its geometric form. You 
modify the object’s transformation matrix by using the MAIN menu item 
(Transform Object]. After you select it, [Transform Object] brings up a 
menu of loaded objects (global transformations are not yet supported). 
The TRANSFORM OBJECT menu is displayed after you select an object. 


You can greatly increase the speed at which an object is transformed by 
using [Substitute Boxes] on the OBJECTDISPLAY menu. [Substitute Boxes] 
performs the transformation by substituting a cube for the object being 
transformed. See Chapter 7—"Displaying Objects." 


You can easily abort out of an interactive transforming session. 
Completed transformations can be undone by initializing an object. 
[Initialize] undoes all transformation performed on an object. 
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a i 
| nm [Initialize] 
= te This option resets the matrix back to the initial, unmodified state, 
| 7 undoing any of the other operations. 
= te 
| Be [Move] 
a im This option translates (moves) the object in x, y, or z. 
[ [Move] Translates the object in its local coordinate 
p it | system. 
J m [Move (M)] Translates in global space. 
| (Move (R)] Allows you to select an axis along which to 
— | move the object. 
a 1 
I % 
—, Line of Sight 
— Fe . Type In Cartesian Direction. 
l am . Type In Spherical Orientation. 
m1 
a 
mt 
= i 
| Ps Figure 4.22 An object moved twice along an axis with [Move (R)]. 
——| (The axis that was selected is shown highlighted.) 
| =e [Position] 
= 1 
| Positioning allows you to move an object by selecting a point in global 
mw Oe space where you want some feature of the object to be located. The 
as object is translated locally, preserving its current orientation and scale, 
! ae so that this feature coincides with the selected point. 
ie id 
[! [Position] Moves the object so that its local origin is 
— | positioned at the selected point. 
mu 
= i 
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[Position (M)] Moves the object so that the element you 
select with the following menu is positioned 


over the selected point. 


ursor 
Object Center 

. Origin. 
. Type In Location. 
Select Element. 


To position an object, you first select the point where you want some 
feature of the object to be positioned. The following menu comes up 


when you use [Position] or [Position (M)]: 


ursor 
Origin. 
.Type In Location. 
Select Element. 


Figure 4.23 Positioning an object 


| 
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[Rotate] 


im 


This menu item rotates the object around orthogonal axes. 


ou [Rotate] Rotates in the object’s local coordinate 
system around its home origin. 
Ul 
JE [Rotate (M)] Rotates in the global coordinate system. 
rs [Rotate (R)] Allows you to select a point around which 
to rotate. 


7] 


Choose location method: 
ursor 
Object Center 
Origin. 
. Type In Location. 
. Select Element. 


ee | 


re 


lm 


Figure 4.24 Object rotated around center of highlighted axis ([Rotate (R]) 
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[Axis Rotate] 
This menu item rotates the object around a selected axis. 


[Axis Rotate] Rotates around a selected axis. 


[Axis Rotate (R)] Rotates around a selected axis and a 
selected point. 


Figure 4.25 Two examples of rotating an object around a selected axis. 
Right, rotating around global y. Left, rotating around edge 
selected to be axis of rotation. 
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a it [Scale] 

| This option scales the three axes uniformly in the object’s local 

ws pe coordinate system. 

[ [Scale] Scales the object uniformly around a local 
= we origin along each of the major axes. 

j [Scale (M)] Scales the object uniformly around a 

e Tu! scaling 

| center or the global origin along each of 
s tik the major axes. 

| [Scale (R)] Allows you to scale the object around a 

ns te selected point. 

| —— 

a ve 

= te 

: ZX 

mn OS 

7 — Figure 4.26 Objected scaled along the selected segment with [Scale (R)]/ 
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[XYZ-Scale] 
This option scales each axis independently in the object’s local coordinate 
system. 
[XYZ-Scale] Scales the object independently around a 
7 local origin along each of the major axes. 
[XYZ-Scale (M)] Scales the object independently around a 
scaling center or the global origin along 
each of the major axes. 
[XYZ-Scale (R)] Allows you to scale the object around a 


selected point. 


BUG 


Figure 4.27 Object scaled [XYZ-Scale] 
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[Axis Scale] 


This option scales along a selected axis. 


ee 


[Axis Scale] Scales the object from its origin along a 
selected axis. 
| a [Axis Scale (M)] Scales the object from a selected point 
- along a selected axis. 
=e 
| [Axis Scale (R)] Scales the object from a selected point 
- i along a selected axis with constant volume. 
= ve 
| —— 
= ie 
| _—— 
Ce: 
= 1 
A 18 Figure 4.28 Object scaled along the selected axis with 
i [Axis Scale] 
= 18 
= 1s 
ain 
m UF 
m Pe 
more 
m ra 
mtr 
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[Local Shear] 


This option distorts an object along a selected local axis (x, y, or z) by 
the distance that object is from the origin in x, y, z. You can select the 
degree to which the distance in any of these axes affects the shear. 


[Local Shear] Shears along the local x axis. 
[Local Shear (M)] Shears along the local y axis. 
[Local Shear (R)] Shears along the local z axis. 


Suppose you want to shear an object along the y axis governed by its x 
dimension. (c-M) to display a menu that lets you specify the amount 
numerically rather than with the mouse. Suppose you want to. displace 
in y half the distance its vertices are from the origin in x. The x- 
component of the y-shear would be 0.5. If you wanted the object to 
displace upward (positive y) on the negative x side (and vice versa), the 
x-component would be -0.5. Figure 4.28 illustrates two subdivided cubes 

. sheared in y with the shearing components -0.5 0.0 0.0. The y 
displacement depends solely on the x-components of the vertices. 
Specifying a nonzero component of the same coordinate as the shear 
direction effectively scales the object in that direction. 


Figure 4.29 Left: after shearing along the local y axis—{Local Shear (M)] 
Right: after shearing along the y axis of the superior—{Shear (M)] 


[Shear] 


[Shear] resembles [Local Shear], but the axes are defined according to 
the axes of the superior. 


[Shear] | Shears along the superior’s x axis. 
[Shear (M)] Shears along the superior’s y axis. 


[Shear (R)] Shears along the superior’s z axis. 


a 
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mF 

| {Bake This] 

om 

I) [Bake This] applies the matrix transformations to the actual geometry 

er and then reinitializes the matrix, making its previously transformed 

7 a position its home position. 

ma 1m 

| A€ [Show] 

i if [Show] prints out the object’s matrices into the 3D live window. 

me 1k 

| wai [Save] 

i ia [Save] allows you to save and name the current transformation matrix. 

I! Once an object’s transformation matrix has been saved, you can [Use 
no Previous] (which appears on the transformation menu once a matrix has 

le been saved) to get menu of all saved transformation matrices for all 

: loaded objects. 
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Manipulating Objects 


i) 


1] 


. Overlays. 
.List Objects. 
Add New Object 


ie] 


. Transform Object. 


. Attributes. 


a 


This chapter describes how to modify objects by performing operations on 
selected elements. Elements of polyhedron are of three types: vertex, 
segment, and face (including general faces). The elements of a wire are 
also of three types: node, winged segment, and winged arc. The range of 
operations includes moving, scaling, rotating, cutting, collapsing, beveling, 
extruding, mirroring, twisting, and randomizing. 


= ‘ 
m. 


im 


Not all operations are applicable to all elements; the 3D editor provides the 
appropriate menu of operations for each element type. Choosing an 


= operation from these menus either sends a message directly to the selected 
element or starts an embedded interactive session to allow you to dynami- 

7 cally manipulate the element so that messages are sent continuously with 

- mouse movements. 

in The operations that are performed on elements are changes to the object’s 

gti geometry and therefore cannot be undone once you have clicked (L) to accept 
the change. 


Note: Aborting out of some operations does not restore the objects to its 
— exact state before the manipulation. See page 107. 


1K Selecting an Element 


— Modifications to an object are made when an element or a collection of 


— elements is selected. An object is selected by first specifying the element 
type in the SENSITIVITY ELEMENT menu, which is located above the view 

= window. 
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collect none points segnents aces o) Ei 


([collect] is described in the section "Collect Mode" on this page.) 


Once an element type is selected, elements of that type are highlighted when 
you move the mouse over the object in the view window. When the 
individual element you want to modify is highlighted, (M) to select it. The 
serial number of the selected element is printed in the view window. 


imlecemb i 


Figure 5.1 Cubes with vertex, edge, and face selected 


To select the body (parent) of the currently highlighted element (c-M). 


Once selected, an element stays selected until you (M). Changing the 
element type by selecting another element within the SENSITIVITY ELEMENT 
menu also deselects any previously selected element. In most cases the 
element remains selected after the operation, so you can do other things 
with it; after other operations, an element is no longer selected once the 
element is removed by the operation. 


When you want to do only one operation to an element, you do not need to 
go through the extra step of explicitly selecting it. When you (M2) to get 
the operations menu, the highlighted element is temporarily selected. Once 
the selected element is modified, it is no longer selected. 


Operation Menus 


To bring up the applicable menu of operations for a selected element, 
either (M2) or (sh-M) in the view window or use [Modify Elements] of the 
MAIN menu. 


Coilect Mode 


Very often you might want to perform the same geometric operation on a 
number of different elements. To do so, you can select each element 
individually and perform the operation on one element at a time, or you can 
use collect mode to collect elements of one type into a group and perform 
the operation once on all of them. 
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Attributes 


-Move. 
Move along axis 
. Scale. 
.XYZ-Scale. 
.Extrude. 


-Move. 
Move along axis 


. Scale. 
.XY¥Z-Scale. 
.Rotate. 
Collapse 
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- Scale. . Scale. 
.XYZ-Scale. .XYZ-Scale. 
.Rotate. -Rotate. 
.Extrude. Sphericize 

.Cut. 
Flip. 

Collapse .Cut. 
Dissolve Lift Vertex. 
Bevel Lift Edge. 

Coplanar Collapse 
Add to Part .Edge Subdivide. 
ede Subdivide. 


.Randomize. 
Edge Subdivide. 
.Vertex Subdivide. 
Inset 
.Bevel. 
-Coplanar. 
Smooth 
.Fractalize. 
Convexify 
Copy. 
.Mirror. 
Copy, mirrored. 
Evert 
.Displace. 
New Displacement 
. Select Elements. 


Convexify 
Chip Off. 
Add to Part 
Attributes 
Assign UV Coords 


Assign UV Coords 


3 nove 
ove along axis 
-Move. , ale 
Nove “it axis .XYZ-Scale. 
.XY2-Scale. New Spline 
Rotate. -Respline. 


Cut. 


: Copy. 
Collapse . Select Elements. 


Figure 5.2 Modification menus for S-Geometry elements 


To collect several elements of one type, use the cursor to select an element 
type and then select [Collect] from the SENSITIVITY ELEMENT menu. (You can 


For example, if you want to perform an operation on several vertices, (M) to 


also (R) when selecting the element type to enter collect mode.) 


select a vertex. Move the mouse so that another vertex is highlighted. 
Notice that the first selected vertex is still highlighted. You can keep 
selecting vertices until all are selected. Clicking on an already collected 
element removes it from the collection. (R) ends collect mode. 


You might want to move the object to select some element obscured by the 
geometry of the object. (c-R) to temporarily halt collect mode. You can 


execute any geometry command and then immediately return to collect mode. 


An operation done on a collected group does not always give the same result 


as when the operation is performed sequentially on individual elements. 
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Saving a Collection 


You can save collections by making them a part. A part is a collection of 
one or more elements of the same type. To create a part, select one of the 
element types in the SENSITIVITY ELEMENT menu and use collect mode. When 
all elements have been selected, (R) to end collect mode and then (M2) or 
use [Modify Element (M)] to bring up the operation menu for that element 
set. Use [Add to Part]. 


[Parts] on the polyhedron menu allows you to reselect a part. [Parts (R)] 
allows you to rename, select, or delete a part. 


Moving the Mouse vs Specifying Numeric Parameters 


You can move objects or elements by moving the mouse or by specifying 
the amount of movement by typing in a numeric value. 


The default mode of operation is to use the mouse to control the degree of 
modification. If the operation is in 83D, moving the mouse left or right 
controls the x axis, forward and backward controls the y axis, and forward 
and backward as you hold the middle button down controls the z axis. 


To specify the amounts precisely, press the CONTROL key while selecting the . 
menu item (either right, left, or middle). An appropriate menu appears to 
let you specify the amounts numerically. 


You can make specifying numeric parameters the default. To do so, go to 
the PARAMETERS submenu in the CAMERA menu and set the default editing 
mode to [Geo Numeric]. This menu item causes the menus to come up 
each time you select a geometric operation. Mouse-controlled operation is 
made available by using the CONTROL key. 


LE 
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Influencing Areas Around Elements 


= 


Certain operations allow you to manipulate not only the selected element 
but vertices that are near it. You can define a spherical area around an 
element so that as the element is manipulated, the vertices within the 
defined area are also influenced by the operation. For example, as a 
selected vertex is pulled, the vertices within the defined area are pulled 
along with the selected vertex as if influenced by it. 


J 


~ 


( 


lia 


lim 


The effect of the influence is greatest on the vertices closest to the 
selected vertex and falls off for the vertices toward the outer edge of the 
sphere. The effect of the influence is 1 at the selected element and 
gradually decreases to 0 at the outer edge of the defined area. The rate of 
falloff can also be controlled. 


ed 


a 


I 


To enable an operation to influence a spherical area, hold down the META 
key while selecting the geometric operation. If you want to type in 
numeric data, hold down both the META and CONTROL keys when selecting 
the operation. This brings up the following menu: 


{mt 


Um 


s Inverse Linear inverse Square Cosine 
Distance route: Surface Shortest ipo 
Set defaults only 


| 
i 


: The distance route determines how the distance from the element to the 
1g outer edge of influence is measured. [Surface] measures from the element 
< in a somewhat straight line, except that the line of measure tends to follow 
edges. [Shortest] measures directly from the element to the assigned 

—Je distance. [Midpoint] creates an imaginary point that is located at the 
"center" of an element or several elements; the outer edge of influence is 
measured from this midpoint. In the case of a single point, [Shortest] and 
— [Midpoint] are identical. 


ik The following figures show a face translated in y. 


, 
ss 5S Se Es 5 ee ee 5 ee es ee ee eee ee a SE SE ae Ea eee 
7 


106 ¢ S-Geometry 


No influence Influence with inverse 
linear falloff 


; 


Influence with inverse Influence with cosine falloff 
square falloff 


Performing Geometric Operations 


The types of modification depend on the type of element; for instance, certain 
operations work on all element types; others work on one, two, or three element 


types. 


When you wish to perform a rigid-body transformation on a whole polyhedron, it 
is frequently more desirable to use the MAIN menu item [Transform Object] on 
the polyhedron’s immediate superior. [Transform Object] displays a menu of 
operations that modify the object’s transformation matrix rather than its 
geometric form. Use of [Transform Object] is preferable for two reasons: 


1. Substitute boxes can be used in transformations, greatly speeding the 
operation. 


2. You can perform any number of sequential operations on the object, with 
the option of undoing all of them. 


The [Bake This] selection on the TRANSFORM OBJECT menu should be used to "set" 
the transformation when the desired effect is achieved. 
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Operations such as [Extrude], [Lift Vertex], and [Lift Edge] are combinations of 
two operations. The first operation makes the topological change to the object, 
in the case of [Extrude], making the new face structures around all the edges. 
The second operation is a geometric operation that moves the element to a new 
position. When you (L) to complete an operation, you are accepting both the 
topological and geometric changes. When you (R) to abort the operation, you 
are actually undoing only the second, or move, operation. As of this release, the 
topological change cannot be directly undone, although an object can be restored 
to its original condition after almost any operation by using a suitable 
combination of other operations. 


Nonplanar Faces 


Nonplanar faces are often caused by two types of operations: operations such as 
[Move] and [Lift] in which vertices are moved and operations such as [Dissolve] 
and [Collapse] in which new faces are formed. The nonplanar face shown here 
was created by moving a vertex relative to the screen. 


sai 


Figure 5.3 Cube with a nonplanar face and 
two ways to cut a nonplanar face 


Normally you do not have to worry about slightly nonplanar faces. 

S-Render triangularizes all faces before rendering them so that the shading of 
such faces is constant over an animation. If you have a severely warped face, 
however, S-Render might subdivide it in a manner you did not intend. Figure 
5.3 illustrates the two ways in which a nonplanar face might be cut. The two 
are rendered quite differently. If you have such warped faces, it is best to cut 
them explicitly yourself. 
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General Faces 


The number of operations you can use with general. faces (or faces with holes) is 
limited. Topological operations that are not yet supported for general faces 
include edge subdivide, vertex subdivide, bevel, coplanar, inset, and convexify. If 
you attempt to apply one of them to a polyhedron that has general faces, S- 
Geometry rejects the operation with a warning. Once all the general faces are 
removed (by cutting), the operation will work. 


The only currently supported topological operations are [Cut] and [Extrude]. 
Extrusion works as it does for simple faces. Cutting is somewhat different. 


When you cut a face with one hole, you can cut from one point on the outer 
perimeter to another, from one point on the inner perimeter to another, or from 
the outer perimeter to the inner. In the first two cases, the cut operation is 
normal, creating an edge between the two selected points and a new (simple) 
face on one side. 


In the third case, however, because a single edge would not divide the face in 
half, two new edges are created between the same two points, and the new face 
is sandwiched between. The polyhedron is still topologically valid, but because 
the two edges are visually indistinguishable, later operations could give 
unexpected results, so S-Geometry issues a notice listing the two edges. After a 
second cut is made to the inner perimeter, it is a good idea to dissolve one of 
the double edges. 


1. Cut the general face. 


Make one cut from the outer to inner perimeter. S-Geometry 
automatically creates two edges since to create one edge 
would not divide the face in half (the face would be touching 
itself). 


Since the two edges are indistinguishable from one edge, 
S-Geometry prints the following notice in the 3d live window: 


ie 


Manipulating Objects « 109 


s3 
Note: Cutting across perineters with TWO edges (#<EDGE 168> and #<EDGE 189>) 
with #<FACE 3> sandwiched between. 


3d Live Window i 


14 

si 2. Make another cut to the face. 

4 

if 

i 

ria 8. Dissolve one of the double edges. 

If it is inconvenient to select one of the edges directly, you 
it can select the edge to be dissolved by moving the mouse over 
= the edge listed in the live window. | 
i= Note: Cutting across perimeters with TWO edges (#<EDGE 186> and 


with &<FACE 3> sandwiched betveen. 
(Abort) 

on 
3d 


mand: 
Live Window 1 


it 
i" When you click a mouse button with the edge selected, the following 
= menu appears: 
aon EDGR TIO9) | Cecn.c 
— #<EDGE 109> 
a7 inspect 
describe 
Input-edit / Kill-ring 
ia set x 
“is related flavors 
init options 
- instance variables 
ia which operations 
—_ structured init options 
structured instance variables 
| structured methods 
| Aim at 
a Geometry 
ars 
igniignt 
= x 
= Use [Select (R)] and notice that the edge is now selected in the 
—_ view window. Once the edge is selected, (M2) to get the edge 
menu of operations and use [Dissolve]. This removes one of the 
la coincident edges and the sandwiched face, leaving two edges that 
= divide the general face into two faces. 
i" 
iz 
ww 
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Choosing a Value for an Axis 


Certain transformations and element modifications such as moves and rotations 
allow you to select a value for an axis along which the operation is to occur. 
Clicking the right mouse button when selecting such operations brings up the 
following menu: 


X. 
ile 


we 
Line of Sight 
. Type In Cartesian Direction. 
. Type In Spherical Orientation. 


[This Element’s Normal] 
Selects an element’s normal to be the axis value. 
This is useful for moving an element in and out 
since those directions are at odd angles and not 
easy to determine in global or local coordinate 
space. Moving along a normal is a constrained 
motion; you do not have to worry about moving the 
element along multiple axes. 


For an edge, the normal is the average of the 
normals of the two adjacent faces. For a vertex, 
the normal is the average of the normals of the 
adjacent faces. Polyhedra have no normal. 
Requesting that a polyhedron move along its 
normal moves it along its local y axis. 


[Select Normal] Allows you to select the normal of any of the 
polyhedron’s elements to use as the axis. 


{Select Segment] Allows you to select any segment or edge to use as 
an axis. 


PX EY); (23 (L) on [X], [Y], or [Z] to use one of the object’s 
local axes; (M) to use a global axes; and (R) to use 
a local axis of another object. 


[Line of Sight] Line of sight axis extends from the eyepoint to the 
aimpoint. 


[Type in Cartesian Direction] 
Defines a direction based on the xyz coordinates 
you supply. 


if a 
— Manipulating Objects e 111 | 
Wi 
7" [Type in Spherical Direction] 
= Defines an arc along which to move the element. 
Although it asks for three coordinates, you need to 

oq supply only two, a and B. a translates as | 
- longitude and § translates as latitude on a globe. | 
it 

Choosing a Location 
ia | 
» Certain operations such as scaling and rotating give you the option of selecting 

a point around which the operation originates. In these cases, clicking right 


8 when selecting the operation brings up the following menu that has several 
options for specifying a point: 


ursor | 
This Element’s Midpoint ‘ | 
Object Center 


it Origin. I | 
. Type In Location. | | 
. Select Element. i 


lt ; 
" [Cursor] Brings up a three-arm cursor that you can move to 
iz any position on the screen. 

[This Element’s Midpoint] 
ig Places the location at the midpoint of the selected | 
nest element. 
ia [Object Center] Uses the center of an object for the location. 
= [Origin] Uses the object’s local origin, the global origin, or 
_ the origin of another object for the location. | 
ia [Type in Location] Allows you to type in an absolute location using 
"es the xyz coordinates. 
! 7 [Select Element] Allows you to use a vertex or the center of a face 

or segment. 
is 
- Geometric Operations 
=| | 
Add to Part faces, edges, vertices 
— A part is a collection of one or more elements of the same type. A 
polyhedron can have several parts made of faces, edges, or vertices. 
a 
ik I 
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[Add to Part] adds elements to newly created parts or existing parts. Parts 
are useful for assigning attributes to multiple elements and for storing 
collected elements. 


Attributes polyhedra, faces, vertices 


If S-Render is loaded, [Attributes] sets the rendering parameters for the 
selected element 


Assign UV Coordinates polyhedra, faces 


If S-Render is loaded, [Assign UV Coordinates] produces a menu that lets 
you select and assign UV values. 


Bevel polyhedra, faces, edges, vertices 


Beveling an edge or vertex removes that edge or vertex and replaces it 
with a face at an angle between the two faces that gi vi to shared that 
edge or vertex. 


A beveled face is created by beveling all of its edges in parallel, cutting 
into the face and each of its neighbors by a certain distance (the default is 
2.0) and creating four new faces that join the original face at an angle. 


Beveling a polyhedron bevels all its edges, or all edges that exceed a 
specified degree of acuteness. 


[Bevel (R)] Polyhedra only. Bevels only the hard edges of 
the polyhedron, the default degree of hardness 
being the current value of the object’s hard- 
edge display parameter. (See the section 
"Displaying Hard Edges” on page 150.) 
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[Bevel (c-L)] Allows you to set the beveling parameters. 
The parameters depend on the type of 
element. 


Reset default width: 
Bevel Width (along Pie 
Max face used-area ratio : 8.3333 
Cutoff hardness (degrees): 44.999992 
Z fi 


Bev 
Max face used-area ratio: 8.3333 


Bevel ( Abort [J 


et default width: 
el edge-length RATIO : 8.2 


Bevel width Distance perpendicular to an edge at which to 
cut the adjoining face(s). 


Bevel edge-length ratio 
Vertices only. Ratio along each bordering 
edge at which to cut the edge. The 
proportion of the edge length. 


Max used-area ratio Faces and polyhedra. Maximum area of the 
3 face that can be used in beveling. This value 
should normally be less than 0.5 (or half the 
available face area) or it is possible that for 
smaller faces the bevels might overlap in the 
middle of the face, causing the face to be 
severely twisted. 


Cutoff hardness Polyhedra only. Minimum angle (in degrees) 
between the normals of adjacent faces for 


which bevels are made. Edges shallower than 
the specified angle are not beveled. 


We 


Figure 5.4 Cubes with beveled edge and vertex, beveled cube 
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Bless polyhedra 


[Bless] verifies that all elements within an encoded polyhedron have been 
correctly connected. Database errors are listed if any are found. Minor 
problems, such as an element’s missing pointer, are corrected if other 
references to the element are located. 


If the polyhedron is valid, a response similar to the following appears: 


---- #<POLYHEDRON 1> ----- 

All vertex-edge-ptrs exist and refer to proper vertices. 
All face-edge-ptrs exist and refer to the proper faces. 
All edges have reciprocally pointing wings and share the 
proper faces. 

~ 


Bridge faces 


[Bridge] creates a passage or tunnel between two faces of the same 
polyhedron or between two discrete polyhedra. 


The faces through which a tunnel is created are general (or holey) faces. 


[Bridge] Selects another (nonadjacent) face to which to 
bridge/tunnel. 
[Bridge (c-L)] Inhibits body checking. Body checking 


ensures that the faces selected for bridging 
are on the same polyhedron. This should 
always be used when creating a bridge 
between discrete polyhedra. 


[Bridge (M)] Selects another (nonadjacent) face to which to 
bridge/tunnel, but triangularizes faces. 


It is advisable to have objects in their home position before bridging them. 
(({Bake This] on the TRANSFORM OBJECT menu reinitializes the matrix, making 
an object’s transformed position its home position.) 


—_ 
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les) 


i: Figure 5.5 Cube with tunnel between inset faces 
- on opposite sides 


7 | Figure 5.6 Concave polyhedra with bridge across void 
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Chip Off faces 
[Chip Off] creates a new object from a selected face. This object is a flat 
polyhedron. 
[Chip Off] Chips off the face and then uses the mouse to 
move it relative to the x, y, and z axes. 
[Chip Off (M)] Chips off the face but leaves it where it is. 
[Chip Off (R)] Chips off the face and then uses the mouse to 
move it relative to the face’s normal. 
Figure 5.7 Flat polyhedron chipped off one end 
of a cylinder 
Collapse faces, edges, vertices 


[Collapse] takes the selected element and reduces it to a point. In the case 
of a vertex, the vertex and all its edges are eliminated and the gap is filled 
with a face. 
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Figure 5.8 From left, collapsed vertex, edge, and face 


Convexify polyhedra, faces 


This command decomposes a face or all faces into convex polygons. 
[Convexify] should be used before an object is shaded on the color monitor 
so that areas outside the faces of a concavity are not filled with a solid 
color. | 


The edges created during this operation can be made invisible by setting a 
cutoff for hard edges. Dissolving the edges restores the original face or 
faces. 


[Convexify] might subdivide a face in a manner you did not intend. If you 
plan to render a nonplanar face that needs to be decomposed and you have 
a preference for how the warped surface should be subdivided, it might be 
better to manually cut the nonplanar face so that you can control how the 
face is rendered. 
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Coplanar polyhedra, faces, edges 


[Coplanar] creates narrow faces on either side of any selected edge or along 
the edges of a selected polyhedra or face. These faces lie in the same 
plane as the faces they abut and are used to limit the shading interpolation 
to the region around the edge. The edge coplanars are of default size. 


[Coplanar (c-L)] Displays a menu that allows you to specify the 
size of the coplanars. 


[Coplanar (R)] Polyhedra only. Creates coplanars on the 
hard edges of a polyhedron. The coplanars 
are of default size. 


[Coplanar (c-R)] Polyhedra only. Displays a menu that allows 
you to specify the size of coplanars on the 
hard edges of a polyhedron. 


Figure 5.9 Original object and object with 
coplanared edges 
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Figure 5.10 Original object and object with hard 
edges coplanared 


Copy polyhedra 


[Copy] creates a geometrically discrete copy of the selected polyhedron, and 
the copy becomes the body of the newly created object. [Copy] should be 
distinguished from the [Reinstance] command of the MAIN menu, which 
makes a new instance of the object but does not physically copy it. See the 
section "Copying and Sharing Geometry between Objects" on page 89 for a 
description of the differences between [Copy] and [Reinstance]. 


[Copy] Creates a copy of the object and moves it 
relative to the x, y, and z axes. 

[Copy (M)] Creates a copy of the object and moves it 
relative to the screen. 

[Copy (R)] Creates a copy and leaves it in the same 
location. | 


Figure 5.11 An object and its copy 


120 e S-Geometry 


Cut faces, edges 
For faces, [Cut] subdivides a face between any two vertices. 


Edges can be cut in three ways: 


[Cut] Cuts the edge exactly in half. 

[Cut (M)] Cuts the edge into three equal segments. 

[Cut (R)] Cuts the edge at a location specified with the 
mouse. 


Figure 5.12 Cube with its face cut (ouch!) 


Copy, Mirrored x polyhedra 


[Copy, Mirrored] creates a new object by copying the geometry of a 
polyhedron mirrored around a selected face. The new object is a separate 
polyhedron the same size as the first but geometrically and topologically 
the mirror image of the first. 


[Copy, Mirrored] Mirrors a new object around a selected face. 


[Copy, Mirrored (M)] Resembles [Copy, mirrored] except that if the 
face is nearly aligned with an axis (x, y, or 2), 
the mirroring takes place as if that face were 
exactly aligned. 


[Copy, Mirrored (R)] Resembles [Copy, mirrored], except it locates 
| the seam at 0 on the mirroring axis. 


be 


Describe 
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[Describe] prints a geometric description of a selected element. 


[Describe] 


[Describe (M)] 


(Describe (R)] 


Prints a description of the topological and 
geometric information of a selected element. 


Prints only the geometric information of a 
selected element. 


Prints only the topological information of a 
selected element. 


Tne following example shows how S-Geometry describes one face of a cube. 


H<FACE 1> 


body: #<POLYHEDRON 1> 


objs: (“CUBE”) 


-edges- -opp. faces- 
H<EDGE 1> U<FACE 6> 
U<EDGE 2> U<FACE 3> 
Y<EDGE 3> H<FACE 5> 
R<EDGE 4> U<FACE 4> 

Displace 


eu a alae 


-Cw vertices- 


U<VERTEX 
R<VERTEX 
U<VERTEX 
U<VERTEX 


2: (=19 28 
CS (aed bo a2 
4 ( 18.8 
1 ( -18.8 


18.8 
18.8 
-18.8 
-18.6 


(impinging edges:) 
18.8)>  (#<EDGE 9>) 
186.8)>  (#<EDGE 18>) 
18.8)> (#<EDGE 12>) 
18.8)>  (#<EDGE 11>) 


polyhedra 


[Displace] allows you to manipulate displacements. A displacement is a 
named, saved state of a polyhedron’s vertices. (Displacements are created 
and named through the [New Displacement] operation.) Saving a series of 
displacements allows you to define certain states of the same polyhedron 
and then to displace the polyhedron within that path or even beyond. 
[Displace] allows you to not only to deform an object’s vertices within the 
defined states of the displacements but to extend beyond the initial state or 


any displacement. 
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Displacements are especially useful for animating nonrigid motions of a 
polyhedron and are commonly used in conjunction with operations with 
influence (see the section "Influencing Areas around Elements" on page 


105). 


[Displace] 


[Displace (M)] 


[Displace (R)] 


Allows you to deform the object toward any 
previously made incremental displacements. 
Brings up a menu of named displacements 
from which to choose one. 


Initializes the body to one of the initial states. 
Invokes a menu from which to choose a 
named initial state. 


Brings up a the following menu: 


nit 
Displace 
Rename 
Delete 


Displacements can be animated from S-Dynamics through a frame action. 
Sending objects an :init-displacement message followed by the name of the 
displacement initializes objects. Sending them a :displace message followed 
by a value and the displacement name displaced by some amount. 


Dissolve 


edges 


[Dissolve] eliminates the selected edge and turns the adjoining faces into 
one face. If the two faces do not lie on a common plane, this command 


creates a nonplanar polygon. 
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Edge Subdivide polyhedra, faces 


[Edge Subdivide] cuts one face (or faces) of a polyhedron into many faces. 


[Edge Subdivide] Subdivides face(s) by creating new vertices at 
the midpoints of each edge and at the 
geometric center of the face, creating 
quadrilaterals. 


[Edge Subdivide (M)] _Inscribes new face(s) through edge midpoints, 
creating triangles. 


Figure 5.18 Left: Face subdivided, creating quadrilaterals 
Right: Face subdivided, creating triangles 


Evert polyhedra 


[Evert] turns a polyhedron inside out, causing the inside faces to point out. 


Extrude faces, edges, vertices 


Extrusion breaks off the selected element from the main polyhedron and 
permits the new form to be pulled away from the main polyhedron. For a 
face, extrusion creates a new face along each edge and leaves the original 
face intact. For an edge, extrusion creates four new faces: two along the 
sides and one each for the top and bottom. For a vertex, extrusion creates 
as many new faces as there are face neighbors: a pyramidal shape with 
the selected vertex at the apex. 


123 
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Once extruded, the selected element can be pulled in two different ways: 


[Extrude] Extrudes an element and moves it along the x, 
y, and z axes. 


[Extrude (R)] Extrudes an element and moves it along the 
ae ' element normal. For an edge, the normal is 
the average of the normals of the two adjacent 
faces. For a vertex, the normal is the average 
of the normals of the adjacent faces. Unless 
you have an excellent feeling for the orienta- 
tion of the object and the camera, this is the 
preferred way to extrude interactively. 


(R) abandons the motion, leaving the element in its original position but 
with new neighboring faces. 


Figure 5.14 Cube with edge, vertex, and face extruded 


Flatten faces 


[Flatten] makes the selected face lie on the same plane. A menu prompts 
you to select an axis. This defines an infinite number of planes 
perpendicular to the selected axis. You are then prompted to choose a 
point that specifies exactly which plane you want, since only one of those 
planes will pass through that point. 


Flip edges 


[Flip] recreates two faces by dissolving the selected edge and reconnecting 
it to points either clockwise or counterclockwise from the current edge. 
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[Flip] Reconnects edges to points immediately 
counterclockwise from current points. 


[Flip (R)] Reconnects edges to points immediately 
; clockwise from current points. 


Figure 5.15 Cylinder with one edge flipped counterclockwise 


Flip Path | winged arcs 


When you create a contour that contains an arc, you cut the arc out of a 
circle. Although both arcs are left after subdividing the circle, the default 
treatment is to use the smaller arc as part of the path. If you later make 
a wire from the contour, you can use [Flip Path] to make the larger arc 
part of the wire. | 


Figure 5.16 Sketch and resultant wire 


ca is 


Figure 5.17 Wire after path of arc was flipped 
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Fractalize polyhedra 


Fractalizing an object gives it a bumpy, random surface. Randomness can 
be created either by clicking (L) to cut edges or by clicking (M) to bevel 
edges. 


[Fractalize] subdivides faces by cutting edges where points are randomly 
placed. (c-L) brings up a menu that allows you to control the amount of 
randomness between the points at which edges are cut. 


The amount of displacement is specified as a ratio of edge length for each 
xyz coordinate. Although these values are usually the same (they default to 
.2), you can emphasize or deemphasize the bumpiness along any axis by 
raising or lowering that value. 


Each iteration approximately triples the number of edges and quadruples 
the number of faces. 


The fractals shown here were created by creating a cube and then 
collapsing a face. The fractal on the right shows the result after one 
iteration, the fractal on left after five iterations. Both fractals have 
bumpiness exaggerated along the y axis (.15 .3 .15). 


Figure 5.18 Fractal created with [Fractalize] 
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I iz [Fractalize (M)] creates randomness by beveling all edges. Fractalizing in 
=> this fashion gives a smooth shape to the whole polyhedron. Using the 
iq CONTROL key while selecting [Fractal (M)] brings up the following menu: 
— , | 
Rancon factor: 8-4 ETO be G rear aa 
I 
= i 
i The fractal on the right shows a cube with a collapsed face after one 
= iteration of [Fractalize (M)]; the one on the left shows five iterations. 
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| Se Figure 5.19 Fractal created with [Fractalize (M)] 
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|| £E Grow polyhedra 
1 11) [Grow] scales the object locally around each face. 
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= 2 
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| €i Figure 5.20 Original polyhedron with two grown polyhedra 
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Inset polyhedra, faces 


[Inset] creates a face inset a specified amount from the edges of the 
selected face. The default distance inset is 2.0. The maximum proportion 
of the face allowed to be consumed by the inset defaults to .2666. This 
value should always be less than 0.5. _ 


Figure 5.21 Cube with one face inset the default amount 


Lift Edge faces 
[Lift Edge] moves a face by partially extruding one of its edges and pulling 
it out. | 
[Lift Edge] Selects and lifts the edge along the global 
axes. 
[Lift Edge (R)] Selects and lifts the edge along the face 
| normal. 7 3 


(R) abandons the motion, leaving the element with new neighboring faces 
but in its original position. 
Lift Vertex faces 


[Lift Vertex] moves a face by partially extruding one of its vertices and 
pulling it out. 


[Lift Vertex] Selects and lifts the vertex along the global 
axes. 
[Lift Vertex (R)] Selects and lifts the vertex along the face 


normal. 


i 
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(R) abandons the motion, leaving the element with new neighboring faces 
but in its original position. 


ee 


Figure 5.22 Cubes with lifted vertex, edge 
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Mirror polyhedra 


[Mirror] duplicates the geometry of a polyhedron by copying it around a 


— selected face. The result is the original object with twice the geometric 
complexity. 

[Mirror] Mirrors the polyhedron around a selected face. 

Ph [Mirror (M)] Resembles [Mirror] except that when the face 
is nearly perpendicular to an axis (x, y, or 2), 

aa the mirroring takes place as if that face were 
= exactly aligned. 
=a [Mirror (R)] Resembles [Mirror] but locates the seam at 0 


on the mirroring axis. 


Figure 5.23 Murrored icosahedron 
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[Copy, mirrored] resembles the mirror command, except that the mirrored 
polyhedron becomes a new object. 


Move polyhedra, faces, edges, vertices 


[Move] moves the selected element in one of three ways: 


[Move] Moves an element along the major x, y, and z 
axes. It is usually helpful to have the axes 
showing during this operation. 


[Move M] Moves an element relative to the camera 
position of the screen. 


[Move R] Moves an element along its normal. For 
polyhedra, the normal is undefined and this 
operation reverts to moving along a major 
axis. 


When you move a face, the other faces move (stretch or shrink) to maintain 
continuity. This is also true with edges and vertices; when they are moved, 
the polyhedron changes in an appropriate way. 


Be aware that it is very easy to make nonplanar faces: with the move 
operation. By moving a vertex at random, it is likely that the adjacent 
faces will be nonplanar. If you intend to render that object and you know 
how you want the object to look, you can use [Cut] to divide the object into 
triangles. If you do not cut faces, S-Render triangularizes the object, 
although the object might be rendered in a manner you did not intend. 


Move Along Axis : polyhedra, faces, edges, vertices 


[Move Along Axis] allows you to select an element as an axis for a move. 


is Elements Norma 
. Select Normal. 
Select Secor: 


Ba i 
ny 
Line of Sight ‘ 
. Type In Cartesian Direction. 
. Type In Spherical Orientation. 
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New Displacement polyhedra 


[New Displacement] saves and names displacements. (See the description 
of [Displace] on page 121.) 


New nane : beginning 
Saving Mode : Absolute Relative 


an m® 


Select New Displacement Parameters: 

New name : middle 

Saving Mode : Absolute Relative 

Displace from: Previous state Other polyhedron 
State : beginning 


Save Displacement State [) Abort [) 


ave Displacenent State (7 


| 


Saving mode [Absolute] saves the current state of the 
polyhedron. This is a list of the absolute 
locations of all the polyhedron’s vertices. 


(a 


[Relative] saves an incremental displacement. 
This is a list of the differences between the 
current state and another state. Only those 
vertices that are actually different are saved. 


| 


in The menu changes so you can specify whether 

= the displacements are made from a previous 
absolute state of the same polyhedron or if 

rn they are made from the current state of 

AeA another polyhedron. 

i Displace from [Previous State] specifies that the 
displacement is a variation of the same 
polyhedron. [Other Polyhedron] is useful only 

= when you have two topologically identical 
polyhedra (same number of vertices connected 

I in the same way), such as solids of rotation, 

— contour solids, and other polyhedra created 
automatically by menu selection. 

L) 

ot State The state from which the new displacement 

ae has been derived. 
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New Spline wires 


— 


These splines were created by first encoding a wire and then using [New 
Spline]. This menu item allows you to create a splined wire from a control 
wire. The splined wire is actually a normal wire whose nodes lie on a 
b-spline cure that uses the control wire’s nodes as control points. 


Splined wires cannot be made from wires that contain arcs. 


[New Wire] brings up the following menu: 


.Move. 
Move along axis 
. Scale. 
.XY¥Z-Scale. 
New Spline 
.Respline. 


.Copy. 
.Select Elements. 


nDivisions The number of segments to the splined wire. 
This number defaults to 4 times the number 
of segments in the control wire. 


Degree Determines the smoothness of the spline. A 
degree of 1 causes the spline to lie exactly on 
the control wire. Higher degrees create 
splines that are smoother and lie further from 
the control points. The default is 3. 

[Degree] should never be a number greater 
than the number of segments in the control 
wire, otherwise you go in the debugger. 


If you later modify the control wire and want to update the splined wire, 
select the splined wire and use [Respline]. 
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Figure 5.24 Original wire, spline wire of 3 degrees 
spline wire of 5 degrees 


Parts polyhedra 


[Parts] Brings up a menu of available parts, choosing 
one of which selects all the elements of that 
part so that you can carry out the same 
operation on all elements of that part at the 
same time. 


[Parts (R)] Brings up this menu: 
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Randomize polyhedra 


[Randomize] adds a degree of noise to a polyhedron. (Note: Aborting out 
of this operation does not precisely restore the object’s shape.) 


[Randomize] Moves each vertex a random amount in a 
random direction. 


[Randomize (R)] Moves each vertex a random amount along its 
normal. The normal for a vertex is defined 
as the average of the normals of adjacent 
faces. 


Figure 5.25 Cube with vertices randomized along 
vertex normals 


Respline | wires 


[Respline] allows you to update a splined wire if you modify the control 
wire from which the spline was created. 
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Rotate polyhedra, faces, vertices 


[Rotate] rotates the element around global axes passing through a selected 
center. 


[Rotate] Rotates the element around the geometric 
center of the element. 

[Rotate (M)] Rotates the element around the global origin 
(x y,Z1 —-0,0;0), 

[Rotate (R)] Brings up the following menu that allows you 


to select a center for the rotation: 


is 
. Select Roeser 
Select oped 


Y, 


a 
Line of Sight 
. type In Cartesian Direction. 
. Type In Spherical Orientation. 


Scale polyhedra, faces, edges, vertices 


[Scale] scales an element relative to its geometric center or relative to any 
arbitrary vertex. 


[Scale] Scales the element relative to its midpoint. 
[Scale (M)] Scales the element relative to a selected vertex. 
[Scale (L)] Lets you choose a scaling center with the 


following menu: 


Choose location method: 


ursor 
This Element’s Midpoint 
Object Center 


. Origin. 
. ype In Location. 
. Select Element. 


Scaling a vertex about itself is meaningless, so [Scale] on the vertex menu 
reverts to scaling from a selected vertex. 
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Select Elements polyhedra 


[Select Elements] selects all the elements of a certain type. 


[Select Elements] Selects all of the polyhedron’s vertices. 


[Select Elements (M)] _ Selects all of the polyhedron’s edges. (c-M) 
selects only the hard edges. 


[Select Elements (R)] Selects all of the polyhedron’s faces. 


Smooth polyhedra 


[Smooth] gives a polyhedron a smoother, rounder appearance by beveling all 
of its edges and vertices. 


Figure 5.26 Original pyramid, pyramid after one iteration 
of [Smooth], pyramid after two iterations of 
[Smooth] 


Sphericize faces 


[Sphericize] allows the vertices of a face to be moved equidistant from a 
specified point, making the face rounder. 


The point can be specified a number of ways with the following menu: 


ursor 
This Element’s Midpoint 
Object Center 


. Origin. 
. Type In Location. 
. Select Element. 


in a wh a mw 


| 


im 


mC 


| oe 


i mh i mh ih 6) 6m 6 


al 


ianipulating Objects e 137 


After the center point is specified, use the mouse to specify a point that 
will locate the outer radius of a circle on which the face’s points will lie. 


Taper 


polyhedra 


[Taper] progressively scales a polyhedron along an axis. 


Scale factor 


Taper axis 


At distance 


From center 


Power 


pelect Taper Par ; 
ervectar ces ft We eben a a 


-68 48.08 
: 1.8 


The percent to scale the polyhedron along 
each of its axes. The default is a taper of 
(1, 1, 1) for the x, y, and z axes, respectively. 
This default does no scaling. To taper an 
object symmetrically by A along the y axis, 
the components factor should be (A, 1, A). In 
figure 5.27 the values are 4.0, 1.0, 0.1. 


The global axis that the taper proceeds along. 
The default is y. 


The reference point on the taper axis at 
which the polyhedron is or would be tapered 
the specified angle. The default is the 
highest point of the polyhedren in y. 


The default is the midpoint of the polyhedron. 
This center defines two things: taper axis 
coordinate (the default is y) specifies the start 
of the taper or the location where the taper = 
0. The other two coordinates specify the 
point through which the taper axis passes. 


The exponential power of the rate at which 
the taper proceeds. The default power of 1.0 
power creates a linear taper. A lower power, 
such as 0.5, tapers quickly near the center, 
then more slowly near the ends. A higher 
power, such as 2.0, tapers slowly at the 
beginning and then more quickly near the 
ends. 
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Figure 5.27 Original object and object after specified taper 


Twist polyhedra 
[Twist] progressively rotates a polyhedron along an axis. 


Belect Tl wist-Feremeteres 2) iter Swen ee ea 
Degrees Rotation : @.@ 

Twist axis 3 -¥. 

Distance fron center : 42.8 

Center located at : -28 42.00 08 

Power : 1.0 

Symmetric to center? : Yes No 


wist Previous [) Abort () 


Degrees rotation The number of degrees to twist the 
polyhedron from the center to the axis 
location. 


Twist axis The global axis that the twist proceeds along. 
The default is y. 


Distance from center The reference point on the twist axis at which 
the polyhedron is or would be twisted the 
specified angle. The default is the highest 
point of the polyhedron in y. 


Center located at Specifies both the point in space through 
which the twist axis passes, and the center of 
the twist, that is, the point on the axis at 
which no effect occurs. The default is the 
midpoint of the polyhedron. 
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Power The exponential power of the rate at which 
the twist proceeds. A 1.0 power does a linear 
twist. A lower power, such as 0.5, twists 
quickly near the center, then more slowly 
near the ends. A higher power, such as 2.0, 
twists slowly at the beginning and then more 
quickly near the ends. 


Symmetric to center? Specifies whether the twist reverses direction 
on either side of the center. 


Figure 5.28 From left: original object; twist centered at 
the bottom of the object; twist centered at 
the middle of the object; not symmetrical about 
the center; symmetrical about the center. 


Vertex Subdivide (polyhedra, faces) 


[Vertex Subdivide], using existing vertices, cuts one face (or faces) of a 
polyhedron into triangular faces. 


[Vertex Subdivide] Subdivides face(s) between the existing 
vertices and a new center vertex, creating 
triangles. | 


[Vertex Subdivide (M)] Faces only. Selects a vertex from which to 
subdivide. 
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Figure 5.29 Left: original object 
Middle: face subdivided between existing vertices 
Right: face subdivided from a specified vertex 


XYZ Scale 


[XYZ-Scale] scales an element along each of the element’s local coordinate 


axes. 
[XYZ-Scale] Scales the element around its midpoint. 
[XYZ-Scale (M)] Scales the element around a selected vertex. 
[XYZ-Scale (R)] Brings up the following menu to let you 


choose a scaling center. 


oose locatic 


ursor 
This Element’s Midpoint 
Object Center 
. Origin. 
. Type In Location. 
. Select Element. 
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The UTILITIES menu allows you to manage objects or groups of objects. 


Utilities: 


Add Attachment 
. Number. 
Kill. 


Restructuring Objects 


[Restructure] collects several objects to form one new composite object. 
For example, if you have created a door by making four separate objects— 
a door handle, two hinges, and the door itself—they can be collected and 
iE made into one named object with this command. 


—, You can use grouping to establish levels of geometric hierarchy. This is 
= particularly useful to build objects you are going to animate with 
S-Dynamics. (See the document S-Dynamics.) 


im 


When you select [Restructure], a menu of all objects and groups of objects 
appears. Use the mouse to select the objects you want to group together. 
When you use [Do It], the following menu appears: 


Regroup 2 objects into: 7 
xIStINg Object New object 


This menu allows you to add objects to an existing group of objects or 
group them into a new object. If you are making a new object, you are 
then prompted for a name for the group of objects. If you are adding an 
object to an already existing group, you’re prompted for the name of the 
group. 
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Renaming Objects 


[Rename] renames an object. S-Geometry assigns an object a unique name, 
such as "Cube<3>," when it is added to the environment. However, an 
assigned name does not necessarily reflect the nature of the object, and a 
name that describes the initial state of an object with relative accuracy— 
such as cube or sphere—might become inappropriate once the object has 
undergone extensive modification. [Rename] enabies you to keep an object’s 
name descriptive of its current state or its intended use. 


Default Lights 
table—leg-cs 


table-leg-contour 
sf99 
wires—group 
TETRAHEDRON 
bright-light 


Select New Name for “table-leq-cs”: 
CUT Sa a Seen ee ee ee Oe ee eee 


Name : table-leg-cs 


Rename [) Default Name () 


Binding a Lisp Symbol to an Object 


The Lisp symbol GLOBAL:] is bound to the currently selected polyhedron, 
face, edge, or vertex in the view window. [Setq J] can be used to bind J to 
a specific object where it can be used by a program or inspected from the 
Lisp Listener. Whenever this symbol is bound, its previous value is held in 
the symbol JJ. 


Printing Data About Objects 


[Print Data] prints known information about an object or the camera. (L) 
to print geometric and topological information. (R) to print screen 
coordinate data for an object. 


Adding Attachments 


[Add Attachment] currently adds four types of attachments to objects: 
scaling centers, rotation axes, and point and infinite lights. A scaling 
center is a point that any scaling operation is performed around. A 
rotation axis is the axis around which rotation occurs. Lights are 
geometric objects that illuminate other geometric objects for shading and 
rendering purposes. 
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When you use [Add Attachment], the following menu prompts you to select 
the type of attachment you want to add: 


Select type of attachment: 
Ae Center . 


Rotation Axis 


Point Light 
Infinite Light 


You are next given a choice of where you want to place the attachment. 
The particular menu depends on which object you are adding. 


ursor 
Object Center 
. Origin. 
- Type In Location. 
.Select Element. 


ursor 
Object Center 


Origin. 
. Type In Location. 
. Select Element. 
Select Segment 


-gelect Normal. 
Select Beeman 
ate 
wa 
Line of Sight 
.Type In Cartesian Direction. |} 
. Type In Spherical Orientation. 


There are several reasons to add attachments. Attachments are objects 
themselves. Adding them to an object actually makes them subobjects of 
that object, allowing the attachment to participate in the transformation of 
its superiors. For example, if you were illuminating one part of an object 
with a point light attachment, transforming the object would keep the light 
in its relative position vis-a-vis the object. 


Scaling centers and rotation axes allow you to rotate or scale from any 
point you select. You are not limited to scaling or rotating around points 
that are not origins, elements, or located at an element’s midpoint. 


Rotation axes are especially useful in S-Dynamics because they allow 
rotations around arbitrary axes. S-Dynamics does not currently allow the 
specification of auxiliary parameters to an operation. While this is a 
temporary limitation, it means that in order to rotate around an arbitrary 
axis it is necessary that the object being rotated somehow know ahead of 
time what axis it should rotate around. This is done by making the desired 
axis the object’s selected-rotation-axis, which is a property held by the 
object. When the object is asked to rotate a given amount but an axis is 
not specified, it uses this axis. 
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Unfortunately, this property is not preserved when writing and reading the 
object from file. So, when lacking a selected-rotation-axis, an object chooses 
the first object of type Rotation-Axis among its immediate inferiors. This 
is what happens when you make a rotation axis attachment. S-Geometry 
creates an axis and makes it an inferior of the object and also makes it the 
selected-rotation-axis. As long as an object has only one such inferior axis, 
there is no problem. If an object has more than one, only the first is 
recognized, which might or might not be the one desired. So before 
writing out an object, all axes but the desired one should be removed. 


This restriction makes it impossible to rotate around several arbitrary axes 
directly. You need to wrap the object in "dummy" objects, each of which 
has a single rotation axis. This can be done through [Add Attachment], 
but after adding the first axis, you should add each new axis to the inferior 
object created by the last [Add Attachment] (the objects usually named 
"Egsential-..."]). This results in a nested sequence of objects, each level of 
which has its own axis. Then in S-Dynamics, apply one rotate sequence to 
each level of the object. 


Numbering Objects 


[Number] prints element serial numbers over the line drawing of the 
object. (L) to print serial numbers for all visible vertices within the 
selected object. (M) to print serial numbers for all edges. (R) to print 
serial numbers for all faces. 


Figure 6.1 Cube with edges numbered 
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Killing Objects 


[Kill] kills an object. (L) to list a menu of objects from which you can 
select the object to kill. [Any or All] lets you kill all or several items at 
once. 


If the object is a multiple-object group, clicking (L) on the object deletes all 
objects that make up the top-level object; clicking (R) on a multiple-object 
group, brings up a menu of that object’s inferiors. 


(M) to restore the last killed object. 
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Displaying Objects 


The OBJECT DISPLAY menu allows you to select which objects are visible and 


how visible objects are displayed. An object can be displayed with 
backfaces visible, soft edges removed, points marking vertices, or 
silhouetted with interior lines removed. 


Visibility. 
Backfacing 
Silhouetting 
Hard Edging 

Points 

Substitute Boxes 


When selected, each menu item displays a menu of all existing objects. 
You select the objects you want for the specified property by using the 
mouse to mark the object. 


Select visible objects: 
Do it 


all objects 
Default Lights 


table-leg—contour 
brit oht 


Any top-level or inferior object can be selected. (L) or (M) to select an 


entire object group. Selection of an entire group is indicated on the menu 
by a solid black box around the group name. For example, in the menu 
shown above, all objects within the top-level object group "sf99" have been 
selected. 


To select only certain inferior objects within an object group, (R) on the 
object group to display a menu of the object’s inferiors. Selection of an 


(es) | 


inferior object within a group object is indicated by a gray box around the 
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level object. ("table-legs" has at least one selected inferior object belonging 
to it although the group "table-legs" itself is not selected.) Clicking on 
_"table-legs" brings up a list of its inferiors. 


Meturn 


Clicking on an item a second time deselects or unmarks it. Using the item 
[All Objects] marks all listed objects for the specified property. Once the 
selection of objects has been made, the [Do It] item at the top of the menu 
changes the display as indicated. Moving off the menu aborts the change 
of display properties. 


The [Return] item on the menu returns you to the previous menu. 


Displaying Object Visibility 


[Visible] determines what objects can be seen in the view window. 


[Visibility] Displays a menu of all defined objects. 
3 Selecting an object makes that object visible 
and makes all other objects invisible. 


[Visibility (M)] Makes all objects invisible. 


[Visibility (M) or (R)] Also displays a menu that lists all defined 
objects. However, this menu allows you to set 
the visibility of several or all objects. 


Note: An object that has been marked visible is not visible when it is not 
within the camera’s field of view. 
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Displaying Backfaces 


i} 


([Backfacing] displays only the faces that are facing toward the camera. 


im 


S-Geometry knows which way a face is oriented by the order of the vertices 
in that face. 
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Figure 7.1 Left: backfaces removed 
Right: backfaces displayed 
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Displaying Outlines 


lis! 


[Silhouetting] displays only the major outlines of its form when in motion. 
Thisconsiderably reduces the display time of a complicated object while 
retaining its essential shape and orientation. 
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Figure 7.2 Left: normal 
Right: with silhouette edges visible 
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Displaying Hard Edges 


[Hard Edging] displays the boundaries of faces when faces meet at an angle 
greater than a specified amount, that is, at hard edges. [Silhouetting] is 
automatically turned on when soft edges are removed. The following series 
of diagrams show the same object displayed with hard edging of various 
degrees and the effect of silhouetting. 


Figure 7.4 Hard edging of 1.0 degree 
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Figure 7.5 Hard edging of 7.0 


Figure 7.6 Hard edging of 20.0 degrees 


Highlighting Points 


[Points] shows the object with all its nodes, or points, displayed as dots. 

a This is especially useful with wires or with objects that have many vertices 
if with only two adjacent edges, which might appear to blend together if the 
angle between them is fairly small. The size of the displayed points is 
defined by the [Point Display Radius] parameter in the PARAMETERS 
submenu (on the CAMERA menu). 
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Figure 7.7 Example of point display 


Displaying Substitute Boxes 


[Substitute Boxes] displays a substitute box instead of the object to show 
the object’s position and orientation during camera motion and during 
transformations (performed via the TRANSFORM OBJECT menu). All objects are 
given substitute boxes, which are simple geometric forms, often cubes, that 
enclose a more complicated object. The use of substitute boxes greatly 
increases the speed with which camera movements and transformations for 
more complicated objects are performed, because fewer lines need to be 
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Figure 7.8 Cylinder and substitute box for cylinder 


Outputting Objects 


The OUTPUT menu provides five types of output for an object from 
S-Geometry: 


File. 
.Hardcopy. 


.Render. 
. Shade. 
Paint 


Saving the Object as a File 


[File] saves the S-Geometry object as a file on the file system of any 
connected file server host. This is the only way to save an object for use 
at another time. 


Using [File] or [File (M)] brings up the following menu: 


amera 
Light Groups 
any or all 


Default Lights 


$ 
bright-light 
CUBE 


group-of-—two 


[Camera] ailows you to save either the current viewpoint or a previously 
saved view in a file. (See the section "View Submenu" on page 40.) 
Viewpoints are read back in via [Views] on the CAMERA menu. 


[Any or All] brings up a multiple-value version of the same menu. Newly 
created and modified objects appear highlighted. You can select or deselect 
any number of objects to save. On this menu, highlighted [All Objects] 
means all objects will be filed. When you use [Do It], S-Geometry saves 
the objects (without interrogation) into its own file, using the object’s name 
and the default directory as a filename. 
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If you select objects individually, you can record more information with the 
following menu: 


Write “WIRE-Obiject”’s Vital Statistics 


FILENAME : RED: >s-covers>WIRE-Object.obj 
Write-out units : FEET 
Recorded nane : WIRE-Ob ject 
Documentation NIE 
Number elements? : Yes No 
Filename The filename of the object to be saved. 
Recorded name The internal name of the object. 
Write-out units The default is the current global units. 
Modifying this scales all coordinates 
appropriately. 
Documentation Describes the file, project, session, author, 


changes, or any other relevant information 
about the object. The documentation is not 
used by the program. It is useful primarily 
when viewing a file. The default is NIL (no 
documentation). 


Number elements? Whether to number each element of an object. 
The file is considerably larger when elements 
are numbered, but it is easier to read the file 
in the editor (though you rarely need to look 
at the files). The default is No. 


[File (R)] automatically selects all loaded objects for saving to a file, using 
the object’s name and the default directory as a filename; you can use the 
default filename or change it. 
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Printing Hardcopy of a File 


[Hardcopy] transmits the current image in the view window to a 
lasergraphics printer. 


[Hardcopy] Produces a hardcopy with borders. 
[Hardcopy (M)] Produces a hardcopy without borders. 
[Hardcopy (R)] Allows you to choose parameters for the 


hardcopy with the following menu: 


Choose hardcopy parameters: 
Hardcopy device : Daily Mirror Jamie Lee Opaque (not clear) Silver Lake Sentinel 
Line width yas b 
Shaded solids? : Yes No 
Number points? : Yes No 
segments?: Yes No 
faces? : Yes Ne 
Border width ee 
Number of copies: 1 
Page scale : 1.6 


Cover title : Ee Gecnacnn Hardcopy of "“box-8" 


Hardcopy [() Abort [) 


Outputting to Color Windows 


[Render], [Shade], and [Paint] require color windows. Before using a color 
window for the first time, you must define your color hardware to the 
system. This is done only once. 


In addition to the geometry frame windows, you can output an object to a 
geometry color window on a separate color monitor provided there is color 
hardware on the machine and the color system software is loaded. The 
object can be shaded, rendered, or painted on the color window. Shaded 
objects can be manipulated on the color window, and line drawings can be 
output to a color window rather than to the view window. 
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Describing Coior Hardware to the System 


The color windows needed for shading, rendering, or painting require that 
the appropriate color screen be already made. If you are selecting one of 
these operations for the first time, it is likely that no color screen has been 
set up. In this case, when you choose one of the menu items that selects a 
color window for output, you are first presented with a menu of color 
screen types from which you must choose one: 


2k dine<colorscontroller“ineslot:s 
32 bit High res system 
32 bit HDTV system 
32 bit PAL (1.1: 1) system 
32 bit PAL (1.4: 1) system 
32 bit NTSC system 
8 bit High res system 
8 bit HDTV system 
8 bit PAL (1.1 : 1) system 
8 bit PAL (1.4: 1) system 
8 bit NTSC system 


The type of color screen needed is determined by the type of hardware 
available, and it is important that you select one appropriate for your 
machine to avoid potential damage to your color monitor. See the 
document Color System for further details. 


Creating Color Windows without Color Hardware 


Bitmaps allow you to create color windows even if you don’t have the color 
hardware required for displaying color windows. A bitmap is a type of 
color window and can therefore store color data for later display; a bitmap 
cannot, however, be exposed. Bitmaps can also be used to create windows 
that are larger than what your monitor supports. 


You can create a bitmap by clicking (M) whenever you select a color 
window. For instance, to select a bitmap screen, select [Render] or [Shade] 
in the OUTPUT menu and (M) over [Render Window] or [Output Window]. 
Clicking (M) on the PARAMETERS submenu item [Override Color Window] 
also selects a bitmap screen. (If you don’t have color hardware, clicking 
any mouse button creates a bitmap.) 


Choose size for a 
64 


Bitmap Screen 
Screen Width : @ 


Height : 484 
Bits per pixel: 32 


Create Bitmap Abort [) 


The default size of a bitmap is always NTSC resolution (640 x 484). 
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If you are using [Make New] from the color window selection menu (which 
comes up when you (L) on [Render Window]) to create a new color window, 
use the META key before any mouse click to create a bitmap. [Make New] 
allows you to numerically specify the edges of the new render window. 


Rendering Objects 


[Render] enables you to render the current scene in the view window on a 
color window if the S-Render program is accessible and loaded. All visible 
objects, as they appear from the current camera viewpoint, are rendered. 


[Render] 


ender Window 
Background 


Sub-window Tiling 
Sub-window Edges 


Allows you to specify parameters for S-Render 
with the following menu: 


: No Color Window 
: Opaque Color Existing Image Transparent 


s; none 
: entire window 
2 


Destination Gamma :. 2. 


Dither Image? 
Use Matte Channel?: 
Notify Progress? 


: Yes No 
Yes No 
: Yes No 


Render window 


Background color 


The color window to which to render the 
scene. Initially [No Color Window], this item 
must be set to a valid window for S-Render to 
work. Using this item presents you with a 
menu of existing windows on the color screen 
and [Make New] to allow you create a new 
window for the purpose. If no color screen 
has been made, a menu to create one appears 
before asking you for a window. See the 
section "Outputting to Color Windows" on 
page 155 for information on describing color 
hardware to the system. 


If you do not have color hardware, clicking 
(L) or (M) brings up a menu that allows you 
to create a bitmap screen. See the section 
"Creating Color Windows without Color 
Hardware" (page 156). 


The color S-Render gives any blank areas in 
the scene. [Opaque] on a color system 
invokes the color palette from which you can 
choose or edit a color. If you do not have a 
color system, you can type in the numeric 
values for a color. 
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Sub-window Tiling 


Subwindow edges 


Destination gamma 


Note: [Opaque] does not display the types of 
color values you are typing in. It accepts 
RGB or IHS, depending on what default 
setting you have specified in other color 
menus, for instance, in [Shade] or set through 
the light menus. 


[Existing Image] renders the image against 
whatever image is currently in the window. 
[Transparent] renders an image against a 
clear background (no color). The visual effect 
is of rendering against black; however, the 
image has no background, black or otherwise. 
[Transparent] is useful for making an image 
for the alpha channel. 


You can establish subwindow edges by 
creating a grid of rectangles into which you 
can render an image. You create the grid by 
specifying the number of rectangles in the 
grid and the column and row into which to 
render the image. For example, typing div 3 
at 1 1 subdivides the window into 9 
subwindows, 3 across by 3 down, and renders 
the image to the window in the first column, 
first row. Typing div 3 at 3 1 produces the 
same tiling, but the image appears in the 
third column, first row. 


You can render to an area smaller than the 
full size of a specified window. This option 
allows you to specify a rectangle on the color 
screen onto which to render the whole scene. 
The default is [Entire Window]. 


This option affects the interpolation of output 
colors; its effects are subtle. It allows you to 
compensate for nonlinearities in color monitor 
response. The default value, 2.2, corresponds 
to the gamma of typical monitors. When the 
gamma is set to 1.0, no compensation or 
correction takes place. 
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Dither image 


Notify progress? 


[Render (R)] 


Shading Objects 
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Adds random dither noise to pixel values after 
gamma correction. You might want to add 
noise for two reasons. Noise helps smooth 
out the well-defined edges between single-bit 
color increments. It also increases the 
dynamic intensity range of the output 
medium. 


Whether to print status messages at various 
stages of the rendering. The default is Yes. 


Allows you to edit S-Render’s light database. 
See the section "Light Groups" on page 50. 


[Shade] does a fast shading on a color window. 


[Shade] 
[Shade (M)] 


[Shade (R)] 


Out 


Erase Window? 


Shades the scene with faceted images. 
Shades the scene with smooth images. 


Allows you to specify parameters for shading 
with the following menu: 


Choose Color She dunks Parameters: 
Window 


No Color Window 


tput 
Default Object Gales 8.58 6.58 @. ee 
Background Color : 8.68 6.80 8.80 
Default Light Group : *DEFAULT-GROUPs 


‘: Yes No 


All Drawing Sheded? : Yes No 
Color naming mode : AGB IHS name 


Set Parameters [) Abort {() 


Output window 


The color window to which [Shade] draws its 
objects. Initially [No Color Window], this 
item must be set to a valid window for 
[Shade] to work. Using this item presents 
you with a menu of existing windows on the 
color screen and [Make New] to allow you 
create a new window for the purpose. Ifa 
color screen has not been made, a menu to 
create one appears before asking you for a 
window. See the section "Outputting to Color 
Windows" (page 155) for information about 
describing color hardware to the system. 
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Background color 


Default object color 


Erase window? 


All drawing shaded? 


Color naming mode 


If you do not have color hardware, clicking 
(L) or (M) brings up a menu that allows you 
to create a bitmap screen. See the section 
"Creating Color Windows without Color 
Hardware" (page 155). 


The color given to any blank areas in the 
scene. If you have a color system, this option 
invokes the color palette from which you can 
choose or edit a color. If you do not have a 
color system, you can type in the numeric 
values for a color. 


[Shade] uses any attributes previously 
assigned to objects, but any objects without 
color attributes are shaded in this color. If 
you have a color system, the color palette is 
invoked. If you do not have a color system, 
you can type in the numeric values for a 
color. 


Whether to erase the output window to black 
before each drawing. The default is Yes. 


Whether to draw all images to the output 
window in shaded mode, including all mouse- 
controlled objects or camera motion. (To 
direct line-drawing to the color screen, see 
the PARAMETERS menu description in the 
section "Parameters Submenu" on page 33. 
Because color shading is slower than line 
drawing, this is only practical if the scene is 


a relatively simple one. The default is No. 


Sets the displayed representation of colors as 
they appear in menus. RGB and IHS show 
colors as triplets of numbers, while NAME 
prints a phrase describing the color. The 
default is RGB. : 


Live Window Environment 


The menus and windows of S-Geometry’s work area are part of the larger 
live window system. Not all operations to windows are described in this 
section, which is concerned primarily with operations that might be useful 
for S-Geometry. For more information about windows, refer to Volume VII, 
Programming the User Interface, of the Symbolics user documentation. 


The work area of S-Geometry is based on a hierarchy of windows. At the 
top of. the hierarchy is the geometry frame; the four basic interface menus 
and the view, history, and 3D live windows are inferior to it. The inferior 
windows are known as panes. | 


When you select the geometry frame, it becomes exposed. An exposed 
window is sensitive to mouse movements. You can access menus, select 
elements (view window), type commands (3D live window), or read back 
commands (history window) when a window is exposed. A deexposed (or 
buried) window might still be visible, but it is not sensitive to mouse 
movements. In the S-Geometry default configuration, the history window is 
deexposed and lies under the 3D live window. You can access the history 
window by exposing it. 7 


The window system allows you to reconfigure the work area by moving 
panes and menus, changing the size and position of panes and menus, 
burying, hiding, exposing, and killing panes. Other windows from outside 
the S-Geometry environment, such as Telnet, Converse, and Editor windows, 
can be created. 


When you want to do an operation that pertains to the entire geometry 
frame, such as reconfiguring or saving areas of the frame, (L) on the gray 
background area of the geometry frame. If the operation has to do with an 
individual pane or menu, place the mouse near the pane until an outline 
appears around it. (R) to bring up an editing menu. 
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Manipulating the Geometry Frame 


When you move the mouse onto the gray area of the geometry frame, the 
mouse line for the live geometry frame appears. You can save an area of 
the frame in a bit-mapped snapshot, select alternate configurations of the 
frame, create and manipulate windows, and perform a variety of frame 
editing operations. 


Saving a Snapshot 


When you (L) on the live frame, you are prompted with a menu that allows 
you to create a bit-mapped snapshot of a rectangular area and save it to a 
new window. 


ave a bitmap snapshot 


When you use the mouse to select the menu, the upper-left corner of a 
frame appears. Use the mouse to position the corner where you want to 
start saving a rectangular area. (L) when the corner is positioned where 
you want it. Now use the mouse to adjust the size and shape of the 
snapshot. (L) again to save it. 


The snapshot is useful when you want to save a scene permanently, even 
after the objects have been killed. 


Creating Other Windows 


To display the geometry frame’s window creation menu, (M) on the live 
frame. The menu lists various windows that can be added to the geometry 
frame: 


dynanic listener 
live listener 
converse 
inspector 
notifications 


pee 
Geometry Viewer 
telnet 


Zmail 
create some other window 
get sone extsting window 


get deexposed pane (nenu) 
reveal hidden pane (nenu) 
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[Editor] Adds an editor window. 


[Dynamic Listener] Adds a Lisp Listener that is part of the Dynamic 
window system on which the Symbolics system is 
based. 


[Live Listener] Adds a 3D live window. The advantage of a 3D 
| live window is that objects and elements as well 
as 3D package symbols are mouse-sensitive. 
Clicking on an object gets you information about 
that object. 


[Converse] (L) to steal an existing Converse window. (M) 
or (R) to create a new one. 


[Inspector] Creates a new Inspector window. 


[Notifications] (L) to steal an existing Notifications window. 
. (M) or (R) to create a new one. 


[Peek] (L) to steal an existing Peek window. (M) or 
(R) to create a new one. 


[Telnet] (L) to create a regular Telnet window. (R) to 
create a scrolling Telnet window. 


[Zmail] Captures the Zmail window. 


[Create Some Other Window] 
Allows you to prompt for and create other 
windows. 


[Get Some Existing Window] 
(L) to grab an existing window. 
(M) to grab an existing window and move it. 
(R) to grab an existing window and reshape it. 


[Get Deexposed Pane (Menu)] 
Allows you to select a pane or menu that is 
currently deexposed. A menu of currently 
deexposed panes and menus is displayed. 


[Get Hidden Pane] Allows you to reveal panes that were hidden 
with [Hide This Window] by bringing up a menu 
of all hidden panes. 
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Editing the Frame and Window Attributes 


(R) on the live frame to display the following menu of frame editing 
operations and window attributes: 


refresh panes 
set configuration 


Choose deexposed gray 
Choose background gray 


[Refresh Panes] Forcibly refreshes all windows in the current 
| frame. 


(Set Configuration] Allows you to choose alternate configurations 
of the geometry frame with the following 
menu: 


Rane this 
save this tna file 
load fron a file 


BIG-LISTENER 
BIG-LISTENER-NO-MENUS 
G-VIEWER 


GEOMETRYx 
GEOMETRY -NO-MENUS 
PREVIOUS 


The first three items on the menu enable you 
to name a current configuration, save a 
configuration in a file, and load a previously 
saved configuration from a file. 


The remainder of the items on the menu 
describe alternate configurations of the 
geometry frame that you can select. 
Examples are shown on the following pages. 
The [Dynamics] configuration provides an 
interface with S-Dynamics; [No-Constraints] 
produces an all-gray frame upon which any 
desired windows can be created. 
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Figure 9.2 Big-Listener geometry frame configuration 
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[Choose Deexposed Gray] | 
Allows you to choose a gray background for 
deexposed inferior windows. The menu that 
appears gives the following choices. 


J 
d 


WHITE 
BLACK 
no graying 


[Choose Background Gray] 


Allows you to choose a gray for the geometry 
frame. 


Editing Panes 


When you move the mouse near the edge of a window, a highlighted frame 
appears around the window to indicate that it is selected and the mouse 
line for the live window system appears. (Many of the window operation 
menus have a menu item that selects a window.) 


Once you select most windows, you can move, bury, hide, kill and resize 
them. You can also perform a variety of editing operations for the 3D live 
window and history window. Operations for the 3D live window are 
explained more fully on pages 169 and 174. 


|) 
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S-GEOMETRY 


Figure 9.3 View window selected 


(R) when a pane or menu is selected to bring up the following editing 


menus: 


ury 0 
hide this window 
kill this window 
move this window 
set edges 


Operations for Sensitivity 
Element menu 


bury th 
hide this window 
kill this window 
move this window 
select 3d Live Window 1 
set edges 


don’t autoexpose 
enable more processing 
disable scrolling 
disable split screen 


Operations for Lisp Listener 


ury this windo 

hide this window 
kill this window 
move this window 


select 3d Editor Pane 1 
set edges 


Operations for view window 


Live History Window 1 
bury this window 
hide this window 
kill this window 
move this window 
expose Live History Window 1 
set edges 


disable split screen 
set autoexpose 


Operations for history window 
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Burying a Pane 


When buried, or deexposed, a pane is insensitive to mouse movements. A 
buried pane is still visible although it might be gray, depending on the 
default gray for deexposed inferior windows. You might want to bury panes 
if you’re not using them and need the space to place an exposed pane. 
Hiding a Pane 

Hiding a pane makes it invisible although it is still there and can be 
selected. 

Killing a Pane 


Killing a pane removes it from the S-Geometry work area. 


Moving a Pane 


(M) to move the selected pane. This allows you to move an outline of the 
selected pane or menu. This outline follows the movement of the mouse. 
(M) to abort. (L) or (R) to set the window at the desired place. 
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Figure 9.4 Moving the view window 
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Live Window Environment 


Figure 9.5 View window in its new position 


3D Live Window 


Because S-Geometry is implemented in Zetalisp/Flavors, you can examine 
geometric constructs or make entirely new ones. The 3D live window is a 
Lisp Listener where you can use Lisp in conjunction with S-Geometry to 
perform a variety of operations specific to geometric objects. 


To inspect geometric objects, place the system in point, segment, face, or 
body mode and select an element in the view window. Type J in the 3D 
live window to bind that symbol to the element in the view window that 
was selected with the mouse. Lisp resonds by returning the symbol #, 
followed by the name of the bound element. 


Cl#<EDGE 2> 
; jCommand: 
; jCommand: fs 
i i#<POLYHEDRON 2> 
Command: f 
#<VERTEX 2 ( -18.0 18.8 1@.8)> 
Command: f 
#<FACE 1> 
Command: 


3d Live Window 1 


When you use the mouse to select the bound element in the 3D live 
window, the mouse line offers the following choices: 
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e (L) to "get" the item as if you typed it. 
e (M) to set the last-value symbol * (asterisk) to the element. 
e (R) to display the following menu: 


#<FACE 1) 
get this item 
inspect 
describe 
Input-edit / Kill-ring 
set x 


related flavors 
init options 
instance variables 


which operations 
structured init options 
structured instance variables 
Structured methods 


Aim at 
Geometry 
Neighbors 
Highlight 

Select 


The default menu operations for a vertex, edge, or polyhedron are identical 
to those for a face with the exception that the last five operations—{Aim 


At], [Geometry], [Neighbors], [Highlight], and [Select}—are not available for 
polyheda. 


The last five items are described first. 


[Aim At] Centers the bound element in the view 
window. 

[Geometry] Prints geometric information about the bound 
element. 

[Neighbors] Prints topological and neighbor information 
about the bound element. 

[Highlight] Highlights the bound element in the view 
window. 

[Select] Selects the bound element in the view window 


and highlights it. 


| | T 


oll 


[Get this Item] 
[Inspect] 
[Describe] 


[Input-edit/Kill-ring] 
[Input-edit/Kill-ring (R)] 


[Set *] 


[Related Flavor] 
[Related Flavor (M)] 
[Related Flavor (R)] 


[Init Options] 
[Init Options (M)] 
[Init Options (R)] 


[Instance Variables] 
[Instance Variables (M)] 
[Instance Variables (R)] 


[Which Operations] 
[Which Operations (R)] 


[Structured Init Options] 

[Structured Init Options (R)] 

[Structured Instance 
Variables] 

[Structured Instance 
Variables (R)] 


[Structured Methods] 
[Structured Methods (R)] 
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The following operations are used primarily for getting information about 
the composition and functionality of an element’s flavor. 


Gets this item as if you typed it. 
Does an (Inspect Item). 
Does a (Describe Item). 


Places the bound item in the input editor. 
Places the bound item on the kill ring. 


Sets * to the item without printing anything. 


Dependents. 
Components. 
Tree of all components. 


Names only. 
Matching names. 
Matching names and values. 


Names only. 
Matching names. 
Matching names and values. 


Lists operations this instance handles. 
Lists matching operations. 


A structured list of init options for 
the object. 
Select a substring to match. 


A structured list of instance-variables for 
the object. 
Select a substring to match. 


A structured list of methods for the object. 
Select a substring to match. 


a we wm wy 
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Programming S-Geometry 


S-Geometry is written in Zetalisp, a dialect of the Lisp programming 
language. It also makes extensive use of Flavors, an object-oriented 
extension to Lisp. The Symbolics Genera environment provides the 
programmer with many tools for developing, managing, and understanding 
software systems written in Lisp and Flavors. The programmer can use 
these tools to understand how S-Geometry has been implemented and 

to further extend its functionality. This extension may consist of the 
addition of desired features to the menu interface of S-Geometry, or 

could involve the use of S-Geometry functions as software "tools" in a 
separate application. 


Although this chapter assumes a knowledge of Lisp programming on 
Symbolics systems, it is still of some interest to beginning Lisp 
programmers and programmers familiar with other languages. 


Finding Messages 


This chapter mentions only a few of the many flavor methods defined for 
the various flavors used by S-Geometry. One way to find out about 

other S-Geometry methods employs the current value of the J symbol. 
Whenever an element is selected, the symbol J (SYMBOL-/ is assigned to 
that element. (See the section "Getting to and Using Objects” on page 
187.) By typing J in the 3D live window, the printed representation of the 
currently selected element is displayed. This printed representation is 
mouse-sensitive; by clicking right on it, a menu of actions that can be 
performed on that element is displayed. You can also explicitly set the 
value of J by the [Setq J] item in the UTILITIES menu, and type it into the 
3D live window as before, and click on the printed representation that 
appears. For example, the following menu is the result of a right click on 
the printed representation of an object, in this case, one named "Moon Lander": 
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get this item 
inspect 
describe 
Input-edit / Kill-ring 
set x 


related flavors 
init options 
instance variables 
which operations 
structured init options 
structured instance variables 
Structured methods 


One of the most useful operations in this menu is a right click on [Which 
Operations], which prompts for a substring to match; all methods 

defined for the object or element bound to J that contain the supplied 
string are printed in the 3D live window. For example, if the substring 
"move" is entered with J set to an object, the following list is printed: 


:2axiS-move :%axis-move-local :axis-move :axis-move-local :move 
:move-from :move-local :move-to :move-to-along-axis 
3d:remove-from-light-groups :remove-subobject :x-move 
:x-move-from :x-move-local :x-move-to :y-move :y-move-from 
:y-move-local :y-move-to :2-move :z-move-from :z-move-local 

:Z-move-to ra 


(Not all methods are appropriate for your use; the names of lower-level 
operations that assume a certain calling environment are preceded with - 
a percent sign and typically should not be used in your programs.) | 
These message names are also mouse-sensitive; clicking right on | | 
:Z-move-local produces the following menu: 


METHOD Z-MOVE-TO OBJECT 


arglist 
get this item 
inspect 
describe 
Input-edit / Kill-ring 
set x 
show Method components 
edit/get/disassemble 


If you have purchased the source code files to S-Geometry, 
clicking left on [edit/get/disassemble] loads the source file im 
containing the selected method into an editor buffer, with the cursor 
positioned at the beginning of the method’s definition. 
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Finding Messages In a Dynamic Lisp Listener 


Printed representations of flavor objects are also mouse-sensitive 

in Dynamic Lisp Listeners, which provide you with a set of tools for 
exploring S-Geometry that are similar to those in the 3D live window. 
You can reference the value of J in a Dynamic Lisp Listener by specifying 
the 3D package. Clicking right on the printed representation that results 
from typing in $d:/ produces the following menu: 


Uperation on #<UBJELI “Moon Lander” (multiple) 
ee OBJECT = aes (multiple) 11134357> 
(DESCRIBE #<OBJECT “Moon Lander” (multiple) 11134357>) 


(INSPECT #<OBJECT “Moon Lander” (multiple) 11134357>) 
Edit viewspecs 

Show components of this instance’s flavor 

Show flavors that depend on this instance’s flavor 
Show initializations of this instance’s flavor 

Show instance variables of this instance’s flavor 
Show methods of this instance’s flavor 

Show operations on this instance’s flavor 

Marking and yanking menu 

Presentation debugging menu 

System menu 

Window operation menu 


Many of these operations are similar to those in the menu produced in 
the 3D live window. Many are simply shortcuts to Command Processor 
commands that are also helpful in the exploration of S-Geometry, and are 
described in the sections that follow. 


Finding Symbols 


The Command Processor Command Find Symbo! lists all symbols that contain 
a given substring. You can also specify the packages to be searched, and 

the type of Lisp object the symbol represents, whether it is a function, a 
variable, a presentation type, etc. For example, to find all the bound 
variables in S-Geometry that contain the substring "camera", you would 

enter the following command: 


Command: Find Symbol camera :Packages 3d :Type Variable 


The following is then displayed: 


Searching GEOMETRY for variable symbols with names containing CAMERA 
In package GEOMETRY 

3D: *DEFARULT-CAMERA-FORMAT* - Bound . 

3D: *DEFAULT-CAMERA-TABLE-SIZE* - Bound 

3D:CAMERA - Bound 

3D: CAMERA-SETTING-MESSAGES - Bound 

3D: CAMERA-SETTING-FUNCTIONS - Bound 

ese Done 
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The output of the Find Symbol command is mouse-sensitive. For 
example, clicking (M) on 3d:camera above is identical to evaluating 
(describe 3d:camera). As with the previous examples, a right click 
produces a menu of possible actions to be performed on the object. 


Finding Flavor Definitions 


Once you know the flavor name of a given data structure, you can use other 
Command Processor commands to explore its structure and defined methods. 
The possible commands are the following: 


Show Flavor Components Show Flavor Handler Show Flavor Dependents 
Show Flavor Operations Show Flavor Initializations 

Show Flavor Differences Show Flavor Instance Variables 

Show Flavor Functions Show Flavor Methods 


(You can see this list if you enter Show Flavor at a Command Processor 
prompt and press the HELP key.) 


For example, to see all the instance variables of the vertex flavor, enter 
the following command: 


Command: show Flavor Instance Variables (flavor name) 3D: VERTEX 
This displays: 


NEXT-ELEMENT SERIAL-NUMBER 


PREVIQUS-ELEMENT X 
PROPERTY-LIST Y 
SEGMENT-PTR Zz 


The following command displays all the instance variables of the flavor 
3d:3d-editor-pane (the flavor of S-Geometry’s camera) that contain the 
substring "menu": 


Command: Show Flavor Instance Variables 3D:3D-EDITOR-PANE :Match menu 


CAMERA~MODE-MENU ENCODING-MENU RESTART -MENU 
CAMERA-MOTION-MENU NEW-OBJECT-MENU SENSI TIVITY-MENU 
CAMERA-STATUS-MENU NO-OP-MENU TRANS-OBJECT-MENU 
EDI T-MENU OBJECT-DISPLAY-MENU UTILITIES-MENU 
ELEMENT-MENU-ALIST | OUTPUT-MENU VIEW-MENU 


ENCODING-CHECK-MENU PRIMITIVES-MENU 


The commands for examing flavor definitions duplicate in many ways 

the techniques in the Flavor Examiner. However, the output for a Command 
Processor command can be written into an editor buffer and then marked 
and yanked like normal text. 
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To direct the Command Processor output, use the keyword argument 
:Output Destination with one of the following destinations: buffer, 
file, printer, stream, or window. 


For more information about flavors, see the chapter "Flavors" in 
Volume 2A of the system documentation for Symbolics Genera. 


inputting Numeric Data 


S-Geometry accepts only single-precision floating-point numbers. You can 
get around this restriction by using the methods 2l:float and cl:float to 
coerce generalized numeric values to floating-point numbers. l:float is 
the preferred way to coerce numeric data in S-Geometry. 


cl:float number &optional other Function 
Converts any noncomplex number to a floating-point number. 
With no second argument, if number is already a floating-point, 
number is returned. If number is not of floating-point type, a 
single-float is produced and returned. 


If the second argument other is provided, it must be of floating-point 
type, and number is converted to the same format as other. 
For example, 


(float 3) => 3.@ 
(float 3 1.8d8) => 3.8da 


For a table of related items, see the section "Functions that Convert 
Numbers to Floating-point Numbers" in volume 2A of the Symbolics 
Genera system documentation. 


Zl:float number &optional other Function 
Converts number to floating point with the precision of other; 
with single argument, converts number (if nonfloating) 
to single-precision floating point, else returns number. 


zi:dfloat x 
Converts a number to double-precision floating-point number. 


zl:float x 
Converts a number to a single-precision floating-point number. 
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Packages 


GEOMETRY, nicknamed GEOM or 3D. Unless otherwise specified, all 
symbols are in the 3D package. All message names are in the KEYWORD 
package. 


Starting Up 


3d:make-3d-editor &rest frame-options Function 
&key force-create (configuration :geometry) 
(editor-flavor ’3d:3d-editor-pane) 
The basic function for creating an S-Geometry editor frame. 


Getting to the Camera 


Camera Variables 


camera Variable 
The most recently selected view window. 


geometryframe Variable 
The camera’s frame (superior). 


Camera Flavors 


aimed-locus Flavor 
The flavor that controls the basic manipulation of the camera, of 
the eyepoint and aimpoint. 


view-window Flavor 
The basic camera flavor, which does line drawing and controls 
the menu interface. 


dynamic-eyepoint-mixin Flavor 
A mixin that provides double buffering for the camera window. 


camera-mixin Flavor 
A mixin that simulates real-world camera properties. 
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screen-record-mixin 


Flavor 
A mixin that gives the camera its mouse-sensitivity to elements 
on the screen. 
geometry-edit-mixin Flavor 


Provides the menu system and mouse control for editing geometric 
elements, 


hidden-line-mixin 


Flavor 
Provides messages supporting the camera’s opaque face mode. 
encoding-mixin Flavor 
Provides the sketching window for encoding contours, etc. 
multiple-view-mixin Flavor 
Provides the facility of multiple view windows. 
3d-viewer-window Flavor 


A basic version of a viewer. Includes double buffering and camera 


emulation but no editing or opaque face capabilities. The flavor of 
the subsidiary multiple windows. 


3d-editor-window Flavor 


The flavor of S-Geometry’s main camera window. Includes all major 
capabilities. 


geometryframe _ Flavor 
The flavor of S-Geometry’s frame. 


Manipulating the Camera 


Many of the camera messages, such as :z-move-local and :forward are 
synonymous and are provided simply for convenience. The difference between 
direction and orientation is that direction refers to values that represent 
Cartesian vectors and is expressed in differences in x, y, and z. Orientation 
refers to Euler angles and is expressed in degrees. 
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Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


*fixed-aim-default* Variable 
A global variable defaulting to t. 


sinitialize-transformation of aimed-locus Method 
Clears out the transformation matrix, putting the camera in its 
home position. 


seyepoint of aimed-locus Method 
Returns the location, in x, y, and z, of the camera’s location. 
Because the aimed-locus flavor is based on locus, it also handles 
the :coordinates method and returns the same values. 


:Shift-eyepoint rts ups fwd &optional (global-op t) Method 
fixed-aim? of aimed-locus 
Displaces the eyepoint. This is a generalized move operation, 
the mode of displacement being controlled by the global-op and 
fixed-aim? flags. 


:set-eyepoint x-eye y-eye z-eye &optional fixed-aim? Method 
of aimed-locus 
Sets the position of the eyepoint. The fixed-aim? flag determines 
how the camera reacts to the change of eyepoint. If it is nil, the 
current orientation of the camera is preserved, and the aimpoint is 
reset to a new location. If non-nil, the current aimpoint is preserved, 
and the direction is adjusted. 


sset-x val &optional (fixed-aim? t) of aimed-locus Method 
sset-y val &optional (fixed-aim? t) of aimed-locus Method 
sset-z val &optional (fixed-aim? t) of aimed-locus Method 


Set the individual components of the eyepoint location. The 
fixed-aim? argument has the same meaning as it has for the 
:set-eyepoint method. | 


saimpoint of aimed-locus Method 
Returns three values for the location of the aimpoint. 


:set-aimpoint x0 yO z0 &optional (fixed-eye? t) of aimed-locus Method 
Sets the location of the aimpoint by specifying all three coordinates. 
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The fixed-eye? argument determines what happens to the camera 
eyepoint. If fixed-eye? is nil the current direction is preserved and 
the eyepoint is relocated. If non-nil, the eyepoint stays put and the 
orientation is adjusted. 


sset-x-aim aim-x &optional (fixed-eye? t) of aimed-locus Method 
sset-y-aim aim-y &optional (fixed-eye? t) of aimed-locus Method 
sset-z-aim aim-z &optional (fixed-eye? t) of aimed-locus Method 


Set the individual components of the aimpoint location. The fixed-eye? 
argument is the same as the argument for :set-aimpoint method. 


sset-eye-and-aim xeye yeye zeye xaim yaim zaim Method 
of aimed-locus 
Sets both location parameters of an aimed-locus. The direction is 
forced to adjust. 


set-orientation avec buvec cvec &optional fixed-aim? Generic Function 
to aimed-locus 
Sets the orientation angles of the camera. These are not x-y-z 
vector components, but are polar coordinates: longitude (or 
azimuth), latitude (altitude), and roll angles, expressed in degrees. 
Zero degrees longitude is the z-y plane. Zero degrees altitude is the 


x-z plane. 
sset-azimuth degrees &optional (fixed-aim? t) of aimed-locus Method 
:set-yaw degrees &optional fixed-aim? of aimed-locus Method 
sset-elevation degrees &optional (fixed-aim? t) of aimed-locus Method 
sset-pitch degrees &optional fixed-aim? of aimed-locus Method 
:set-roll degrees &optional ignore of aimed-locus Method 


Set the individual polar angle components of the direction. 
:set-azimuth and :set-yaw, and :set-elevation and :set-pitch 
are equivalent except for their default values of fixed aim?. 
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set-direction dirx diry dirz &optional (fixed-aim? nil) Generic Function 
absolute-magnitude? to aimed-locus 
Sets the direction to the Cartesian vector specified by components 
dirx diry dirz. 


:rotate-orientation rt-rotate up-rotate cw-rotate Method 
&optional global-op fixed-aim? of aimed-locus 
Modifies the direction by the polar angles specified by rt-rotate 
up-rotate cw-rotate. global-op specifies whether the modification 


occurs in global coordinate frame, or whether the current orientation 
of the camera is used as the frame of reference. The default is to 
use the local space. fixed-aim? indicates whether the eyepoint or the 


aimpoint is to be adjusted to accommodate the new direction. 


smove dx dy dz of aimed-locus Method 
:move-with-aim-fixed dx dy dz of aimed-locus Method 
:x-move distance of aimed-locus Method 
:x-move-local-with-aim-fixed distance of aimed-locus Method 
sy-move distance of aimed-locus Method 
:y-move-with-aim-fixed distance of aimed-locus Method 
:Z-move distance of aimed-locus | Method 
:Z-move-with-aim-fixed distance of aimed-locus Method 
Global incremental translations. 
s:move-local dx dy dz of aimed-locus Method 
smove-local-with-aim-fixed dx dy dz of aimed-locus Method 
:x-move-local distance of aimed-locus Method 
‘left dx of aimed-locus Method 
sright dx of aimed-locus Method 
:y-move-local distance of aimed-locus Method 
:y-move-local-with-aim-fixed distance of aimed-locus Method 
sup dy of aimed-locus Method 
:down dy of aimed-locus Method 
:Z-move-local distance of aimed-locus Method 
:Z-move-local-with-aim-fixed distance of aimed-locus Method 
sforward dz of aimed-locus Method 
sback dz of aimed-locus Method 


Local incremental translations. 


i Ww we 
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smove-to newx newy newz of aimed-locus 
:move-to-with-aim-fixed newx newy newz of aimed-locus 
:x-move-to xloc of aimed-locus 
:x-move-to-with-aim-fixed xloc of aimed-locus 
:y-move-to yloc of aimed-locus 
:y-move-to-with-aim-fixed yloc of aimed-locus 
:z-move-to zloc of aimed-locus 
:Z-move-to-with-aim-fixed “zloc of aimed-locus 


<X-move-aim distance of aimed-locus 
sy-move-aim distance of aimed-locus 
:Z-move-aim distance of aimed-locus 


Method 
Method 
Method 
Method 
Method 
Method 
Method 
Method 


Method 
Method 
Method 


Global translations. Equivalent to the :set-x etc. and :set-x-aim etc. 


methods. 


:swing-horizontal degrees of aimed-locus 
:swing-horizontal-to degrees of aimed-locus 
:swing-vertical degrees of aimed-locus 
:swing-vertical-to degrees of aimed-locus 


Global rotations that assume a fixed-aim condition. 


:pan-horizontal degrees of aimed-locus 
:pan-horizontal-to degrees of aimed-locus 
:pan-vertical degrees of aimed-locus 
:pan-vertical-to degrees of aimed-locus 


Global rotations that do not assume a fixed-aim condition. 


sswing-right degrees of aimed-locus 
:sswing-up degrees of aimed-locus 


Local rotations that assume a fixed-aim condition. 
span-right degrees of aimed-locus 
:pan-up degrees of aimed-locus 


Local rotations that do not assume a fixed-aim condition. 


Method 
Method 
Method 
Method 


Method 
Method 


Method 
Method 


Method 
Method 


Method 
Method 
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:xyz-rotate rotation of aimed-locus 
:xyz-rotate-local rotation of aimed-locus 


Combined rotations. The rotation argument can be anything 
parsable as a triplet, and the rotations are done in y-X-Z order. 


Method 
Method 


:x-rotate degrees of aimed-locus Method 
sy-rotate degrees of aimed-locus Method 
:z-rotate degrees of aimed-locus Method 
Global rotations about each major axis. 
:x-rotate-local degrees of aimed-locus Method 
:up-local-rotate degrees of aimed-locus Method 
:down-local-rotate degrees of aimed-locus Method 
:pitch degrees of aimed-locus Method 
:y-rotate-local degrees of aimed-locus Method 
sleft-local-rotate degrees of aimed-locus Method 
sright-local-rotate degrees of aimed-locus Method 
syaw degrees of aimed-locus Method 
:Z-rotate-local degrees of aimed-locus Method 
:cw-local-rotate degrees of aimed-locus Method 
:ccw-local-rotate degrees of aimed-locus Method 
‘roll degrees of aimed-locus Method 


Additional messages that perform local rotations. 


Drawing Messages 


Messages of the Camera 


For view windows with dynamic-eyepoint-mixin, drawing is double-buffered 
to a separate array rather than directly to the screen. The result of the 
following two messages, therefore, does not become immediately visible. 

Use :refresh-image to make the lines or points appear on the screen. 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


:draw-3d-line xl yl z1 x2 y2 22 of view-window Method 
&optional (alu tv:alu-ior (draw-last-p t) 
Draws a line from x1,yl,z1 to x2,y2,z2. 
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:draw-3d-point x yz &optional (alu tv:alu-ior) Method 
of view-window 
Draws a dot at x,y,z. 


‘redraw optional force-setup? of view-window Method 
Redraws all the objects currently visible and refreshes the screen 
with the new drawing. This is done without opaque faces even if the 
window is capable of it. The force-setup? argument indicates whether 
the window should go over all objects to update the visible object list. 
This is normally unnecessary since it is done whenever an object’s 


visibility changes. But it would be required if you were manipulating 
the visibility of objects in a program. 


sredraw-image &optional force-setup? of view-window Method 
Resembles :redraw, but for those flavors of windows supporting it, 
it takes into consideration the setting of Opaque face mode. If on, 


the image is drawn with opaque faces, otherwise is identical to 
sredraw. 


:Set-aspect-ratio ratio of view-window Method 


Provided the format of the camera is unspecified ([Any]), this message 
sets the aspect ratio to the specified value. 


Current and Selected Elements 


screen-element defstruct 


When in a non-null sensitive mode, the camera sets its current element 
to a structure representing the element closest to the mouse. When an 
element is mouse-selected, the window’s selected element is set to that 
structure. The structure is a screen-element and consists of the 

element’s current index in the window’s appropriate element array, the 


element itself, and the body-display-item to which the selected instance 
of the element belongs. 


el-index Accessor macro for screen-element 
el-inst Accessor macro for screen-element 
el-bdi Accessor macro for screen-element 


(el-inst (send camera :selected-element) ) 
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Adding Items to the Interface 


defedmethod spec args itemspec . body Special Form 
A modification of defmethod for geometry-edit-mixin that keeps 
the element modification menus updated. The single argument sent 
is a screen-element structure. itemspec is an alist, each sublist 
consisting of a menu-item string, the element message, and optionally 
a specific mouse button assigned to the operation and a list of element 
types, if you want to restrict the types to a subset of those that 
might have the same message name. The effect of this form is that 
all editable elements handling the message would have this item added 
or substituted on its edit menu. For example, if you want [Cut (R)] to 
send the element a :cut-at-dist message, except in the case of faces 
(which should be sent a :cut message), you could write a form such as 
the following: 


(defedmethod (:select-cut-element geometry—edit-mixin) (element-struct) 
((*Cut® :cut R (face)) (“Cut" :cut-at-dist R)) 
... (body of method)...) 


:add-main-menu-item item-spec of view-window Method 
Adds the item to the MAIN menu. item-spec is a normal menu item 
list, but must be one which has side effects, since the returned value 
is ignored. The side effects are evaluated in the mouse process. 


:add-new-primitive name generator Method 
&optional documentation of view-window 
Adds an item named name to the menu. generator is a form that, 
when evaluated, returns a body. This body should be of a type 
known to the system. It might also return an object, but the 
generator function should not add this object to view. 
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It 
it Getting to and Using Objects 
i *global-object-list* Variable 
a. The list of all top-level active objects. 
mi si ceria’ 
“a *visible-object-list* Variable 
A list of top-level objects that are visible or have at least one 
ia visible subobject. 
it f Variable 
Automatically set to the most recently selected element, or can 
= be set, from the [Setq /] item on the UTILITIES menu, to one of 
— S-Geometry’s objects. Note: In previous releases this variable 
was named \, but has been changed because that symbol is an 
it escape character in Common Lisp, now the default dialect of Lisp. 
| JJ Variable 
<i The previously selected element or object. 
i | 
HH} Variable 
— The second previously selected element or object. 
ik obod object Function 


- Returns the geometric body of a terminal object. This is equivalent 
to (send object :body) if it has no bdi, or, it it has a bdi 

i | (send (send object :body) :body). If the object is a multiple 

ac object, a list of bodies is returned. 


i4 
obdi object Function 
= Resembles obod, only returns the body-display-item, if it has one. 
it choose-object &optional Function 
= (label "Choose Object:") hiliting-test graying-test 
choose-objects &optional Function 
IE (label “Choose Objects:") hiliting-test graying-test 
eo Present a menu from which you can choose one or several objects. 
ae 
object-named name &optional visible-only Function 
— Returns the first object found with the given name (a string). 
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objects-of-type type &optional visible-only Function 
Returns a list of objects that have bodies of the type specified (for 
example, ’3d:polyhedron, ’3d:wire). 


isolate object Function 
Makes all objects except the specified one invisible. 


objects-modified-since-save Function 
Returns a list of objects that have been either newly created or 
modified since they were read in or last saved to a file. 


add-object-to-view object &optional :add-mode Function 
(notification-stream t) 
Adds the specified object to the global object list. 


readin-object object-filename &optional Function 
(path-translator *pathname-translator*) 
Reads in an object from the specified file and adds it to the global 
object list. 


writeout-object object Function 
Writes an object to a file whose pathname is determined either 
by the file from which it was read, if any, or the name of the 
object merged with the current directory defaults. 


save-all-objects Function 
Prompts for each object that needs saving and writes it to its 
default file pathname. 


kill-object object &optional (keep-sisters nil) Function 
Removes the specified object from the global object list. 


kill-all-objects object &optional (keep-sisters nil) Function 
Removes all objects from the environment. 


hide-all-objects  Funetion 
Makes all objects invisible. 


| pam | 
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Manipulating Objects 


A useful function, and the one most object messages (below) use, is 
alter-3d-matrix. See page 215. 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data" (page 177). 


The following messages, which perform transformations on objects, are all 

of the flavor objects: 

sinitialize-transformation of object Method 
Clears out the transformation matrix, putting the object in its 
home position. 


sbake-current-transformation of object Method 
Transfers all transformations in the object’s matrix down to the 
raw data of the underlying geometric body, and clears the matrix. 
The net effect, which cannot be undone, is to make the object’s 
current position its home position. 


salign-to global-vector of object Method 
Aligns the object’s local z-axis so that it points along the specified 
global direction. 


:align-to-local vector of object Method 
Aligns the object’s local z axis so that it points along vector, specified 
in the object’s own local coordinate system. 


srotate degrees &optional Method 
(axis (send self :get ’3d:selected-rotation-axis)) of object 

srotate-local degrees &optional (axis *standard-y-axis*) Method 
of object 


Rotate degrees around axis. axis is anything that can be parsed as 
a vector, including segments, edges, and a list of three components. 


sxyz-rotate rotation &optional (center *standard-center*) Method 
of object 

:xyz-rotate-local rotation &optional (center *standard-center*) Method 
of object 


rotation is anything that can be parsed as a triplet (list, vector, 
segment, etc.). The rotations are performed in y-x-z order. 


190 e S-Geometry 


:x-rotate degrees &optional (center *standard-center*) 
of object 
:x-rotate-local degrees &optional (center *standard-center*) 


:y-rotate degrees &optional (center *standard-center*) 
of object 
:y-rotate-local degrees &optional (center *standard-center*) 


:z-rotate degrees &optional (center *standard-center*) 
of object 

:z-rotate-local degrees &optional (center *standard-center*) 
of object 


sroll degrees of object 
:cw-local-rotate degrees of object 
:cew-local-rotate degrees of object 


Rotate around the local z axis (equivalent to :z-rotate-local). 


:pitch degrees of object 
sup-local-rotate degrees of object 
:down-local-rotate degrees of object 


Rotate around the local x axis (equivalent to :x-rotate-Iccal). 


syaw degrees of object 
sright-local-rotate degrees of object 
sleft-local-rotate degrees of object 


Rotate around the local y axis (equivalent to :y-rotate-local). 


stranslate mover of object 
stranslate-local mover of object 


Method 


Method 


Method 


Method 


Method 


Method 


Method 


Method 
Method 


Method 
Method 
Method 


Method 
Method 
Method 


Method 
Method 


Modify the matrix by mover, which is anything that can be parsed 


as a triplet. 


en 
5 
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HY: 

| a stranslate-to location of object Method 

d it :translate-to-with-aim-fixed location of object Method 

| ‘1 Set the matrix translation to location, a triplet. 

| ry smove-to xyz of object Method 

y 2 An absolute global move; like :translate, but the components are 

as tt supplied separately. 

ee | :x-move-to x of object Method 

: sy-move-to y of object Method 

a :z-move-to z of object Method 

| Absolute global operations. Set the location of the object, one 

eo1g component at a time. 

ore smove xyz _ of object Method 

| a :x-move x of object Method 

a it sy-move y of object 3 Method 

| :Z-move z of object Method 

] — Relative global operations, changing all or each of the coordinates. 

mo ih 

| wi smove-local x y z of object Method 

nit :x-move-local distance of object Method 

| er sleft distance of object Method 
‘right distance of object Method 

a it :y-move-local distance of object Method 

| sup distance of object Method 

— :down distance of object Method 

; :Z-move-local distance of object Method 

=n | ‘forward distance of object Method 

| = sback distance of object Method 

mK Relative local operations, moving single coordinates individually. 

eit 

nit 

m uF 


192 e S-Geometry 


saxis-move distance &optional axis of object Method 
saxis-move-local distance &optional axis of object Method 
smove-to-along-axis distance &optional axis cx cy cz Method 
of object 
Move the object distance along the supplied axis, which defaults 
to the y axis. 
sscale scaler &optional Method 
(center (send self :get ’3d:selected-scaling-center)) 
of object 
sscale-local scaler &optional (center *standard-center*) Method 
of object 


Scale by scaler around center. scaler is any triplet form. 


suscale factor &optional Method 
(center (send self :get ’3d:selected-scaling-center)) 
of object 

suscale-local factor &optional (center *standard-center*) Method 
of object 


Scale uniformly by factor around center. factor is a number. 


sscale-to max-dimension &optional min-dimension of object Method 


Scales by an amount appropriate to bring the object’s size to 
max-dimension, which is a triplet. Unless min-dimension, also 
a triplet, is supplied, it centers the object. 


saxis-scale factor axis &optional Method 
(center (send self :get ’3d:selected-scaling-center)) 
of object 

saxis-scale-local factor axis &ovcional Method 
(center (send self :get ’3d:selected-scaling-center)) 
of object 

saxis-scale-compensated factor axis &optional Method 
(center (send self :get ’3d:selected-scaling-center)) 
of object 

:axis-scale-local-compensated factor axis &optional Method 
(center (send self :get ’8d:selected-scaling-center)) 
of object 
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:x-scale x-fact &optional 


(center (send self :get ’3d:selected-scaling-center)) 


of object 

:x-scale-local x-fact &optional (center *standard-center*) 
of object 

sy-scale y-fact &optional 


(center (send self :get ’8d:selected-scaling-center)) 


of object 

sy-scale-local y-fact &optional (center *standard-center*) 
of object 

sz-scale z-fact &optional 


(center (send self :get ’3d:selected-scaling-center)) 


of object 


sz-scale-local z-fact &optional (center *standard-center*) 
of object 


Scale by factor, a number, along the appropriate axis. 


:x-shear factor &optional (center *standard-center*) of object 
:x-Shear-local factor &optional (center *standard-center*) 

of object 
sy-shear factor &optional (center *standard-center*) of object 
:y-shear-local factor &optional (center *standard-center*) 

of object 
:z-shear factor &optional (center *standard-center*) of object 
:z-shear-local factor &optional (center *standard-center*) 

of object 


Method 


Method 


Method 


Method 


Method 


Method 


Method 
Method 


Method 
Method 


Method 
Method 


Shear by factor, a triplet, controlled by the value of the appropriate 


aXls. 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 
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Other Object Messages 


smake-visible &rest ignore of object Method 
Makes all of the bodies of the object visible. 


smake-invisible &rest ignore of object Method 
Makes all of the bodies of the object invisible. 


:object-named test-name &optional pedigree of object Method 
Returns the first object (itself or a subobject) named test-name. 


stop-level-object of object Method 
Returns the object at the top of this object’s hierarchy, which is 
the object itself if it has no superior. 


ssend-all-bdi &rest message of object Method 
Passes the message and any arguments to all the body-display-items 
of the object. 


:duplicate copy-display-params? of object Method 
Returns a copy of the entire object hierarchy, with a new copy of 
each of its bodies, provided they themselves provide a handler for 
the :duplicate message. 


sreinstance of object Method 
Returns a copy of the entire object hierarchy, but with pointers to 
each of its original bodies. 


Geometric Bodies 
The following are some of the element and body flavors defined by S-Geometry: 


essential-3d-thing Flavor 
Mixin that is used in all of S-Geometry’s flavors. Provides a 
number of basic methods. 


body-mixin Flavor 
A mixin that provides various methods for top-level geometric 
entities. 


- 
o- 


| 
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dummy-body Flavor 
Useful as a mixin when you don’t want to provide all the handlers 
for messages likely to be sent to your body. Provides no-op 
handlers. 


Locus-based flavors: 


locus _ A Cartesian triplet representing a point 
in space. 

numbered-locus A locus with a serial number. 

point A locus with body-mixin allowing it 


to be an isolated entity. 


node A numbered locus that knows it is the 
| endpoint of a segment. 


vertex The same, but is an endpoint of an 
edge (part of a polyhedron). 


axis-head A node that is the free end of a 
rotation axis. 


arc-center A numbered locus that represents 
the center of an arc. 


scaling-center A point that serves primarily 
as an origin for scaling. 
Segment-based flavors: 


segment A thing with a serial number linearly 
spanning the space between two endpoints. 


line-segment A segment with body-mixin, allowing 
it to be an isolated entity. 


arc A portion of a circle connecting two endpoints. 


rotation-axis A line-segment that serves primarily 
as an axis for rotation. 


winged-segment A segment that knows the neighboring 
segments connecting with it at either end. 
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winged-arc An arc with two neighbors. 
bi-winged-segment A winged segment that knows of two 


segments connecting with it at each end 
(four neighbors in total). 


edge A bi-winged-segment that knows of two faces 
bordering it. It is the primary element 
of a polyhedron, embodying all its connectivity — 
information. 


Other flavors: 


wire A body composed of a contiguous set of 
winged segments. 


face A more or less planar entity whose perimeter 
is defined by a loop of edges. 


part A collection of arbitrary elements, currently 
constrained to be all of the same type. 


polyhedron A body formed of edges, vertices, and 
faces. It has a ring (linked list) of each of 
these elements, although that is entirely 
for convenience, since the geometry of the 
polyhedron is defined internally by the local 
interconnections of all its edges. 


: 
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Creating Polyhedra 


The following functions create various types of ready-made polyhedra 
(except for the last, which creates a wire). The default location for 
bodies not explicitly specified by a list of points is at the origin. 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


make-bounding-box xmin ymin zmin xmax ymax zmax 
make-cube width &optional (height nil) (depth nil) 
make-tetrahedron radius 

make-octahedron radius 

make-icosahedron radius 

make-grid-polygonoid width height ndivs-w ndivs-h 


make-cylinder radius height &optional (ndivisions 36.) 
(active-angle 360.0) 
(axis ’Y) 
(wedged-poles-p nil) 
(wedge-cut-cyl-p nil) 


make-sphere radius &optional (lat-divisions 18.) 
(long-divisions 36.) 
(active-angle 360.0) 
(axis ’Y) 
(wedged-poles-p nil) 
(wedge-cut-sphere-p _ nil) 


make-lamina coordinate-list 
make-solid-of-rotation contour-list total-swept-angle ndivisions 


axis toroidal? wedge-cut? head-on-axis tail-on-axis 


make-contour-solid contour-list cross-section-list axis 
init-rotation toroidal? wedge-cut-ends? 


make-tube path-list cross-section-list init-rotation 


Function 


Function 


Function 


Function 


Function 


Function 


Function 


Function 


Function 
Function 


Function 


Function 


wedge-cut-ends? self-connecting? &optional enclosing? 


make-wire-from-coordinate-alist alist 
&optional parse-triplet-from-value 
Returns a wire given a list of coordinate lists. 


Function 
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List of Operations 


Each of these operations correspond to a similarly named element editing 
operation available from menus in S-Geometry. Each is described in this 
documentation under the menu item where it appears. Most are in 
Chapter 5—"Manipulating Objects.” 


Each operation is followed by the type of geometric object on which it 
operates. For example, :bless operates on polyhedra only, but :describe 
operates on vertices, edges, faces, and polyhedra. The operations are 
divided into two groups: the first is for interrogating the element to find 
various values and properties, the second for modifying the element. 


Using Flavor Methods 


A typical use of the programming facility in S-Geometry is to combine several 
simple operations into a compound operation within a loop. For example, if you 
wanted to turn a cube into a stack of ten cubes, you could manually extrude and 
move the top face of the stack. Or you could write a program that did this 
automatically, for example: 


(updating-camera-arrays 
(loop repeat 9 
do (send J extrude) 
(send J :move-out 28))) 


(S-Geometry currently prevents you from compiling uca.) 


J always refers to the selected item in S-Geometry, whether it be a vertex, face, 
edge, or polyhedron. In this example, J is the top face of a cube. Each time 
through the loop, the top face is extruded, leaving a new face beneath it. The 
original top face, which is still currently selected, is moved along its normal by 
20 units. (See figure 10.1.) 


te ft 


f 


updating-camera-arrays is a macro that must be wrapped around any form 
that causes topological changes in an object. It can be abbreviated uca. A 
topological change adds (or removes) vertices, edges, or faces to (or from) 

an object. Because it also causes the camera to redraw the scene, it is useful 
even if topological changes are not made. If you are not sure whether a 
message causes a topological change, it is a good idea to wrap uca around it. 


‘i 
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Figure 10.1 Before evaluating expression. 
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Figure 10.2 After evaluating expression: a pillar of cubes 
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Manipulating Polyhedra and Elements of Polyhedra 


Finding Out about Elements 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


sbless &optional (owtput-stream t) (errors-only nil) of polyhedron Method 
Verifies that the selected polyhedron is correctly formed and attempts 
to fix minor discrepancies. 


:vertex-numbered number of polyhedron Method 

sedge-numbered number of polyhedron Method 

‘face-numbered number of polyhedron Method 
Return the polyhedron’s element whose serial number is the supplied 
value. 

coordinates of locus Generic Function 

:coordinates of locus Method 


Return the x, y, and z components of the element’s location. 


:describe-self of locus, segment, face, polyhedron Method 
Describes in detail the selected item. 


get-direction to segment, vector Generic Function 
Returns the x, y, and z components of a vector parallel 
to the element. 

:dimensions of polyhedron Method 


Computes and returns the size of the polyhedron. 


find-midpoint dummy-body Generic Function 
of locus, segment, face, polyhedron 
Computes and returns the geometric midpoint of the selected item. 


find-normal &optional 6di (normalize? t) Generic Function 
of face, edge, vertex 
Computes and returns the normal of the selected item. (The normal 
is the direction "out" from the surface of the item.) The results are 
in local coordinate space unless the optional bdi is supplied, in which 


- 
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case the normal is returned transformed, in global coordinate space. 
The two results differ when the object to which the element belongs 
has been transformed. 


find-normal-plane &optional bdi to face, edge, vertex Generic Function 
Resembles :find-normal but also returns a fourth value, which 
represents the distance from the origin to the plane. 


get-normal bdi (normalize t) to face, edge, vertex Generic Function 
Looks up and returns the last stored value for the normal of the 
selected item. A bdi must be supplied and the results are in global 
space. 


get-hardness edge to edge Generic Function 
Returns a value that is the hardness of the edge. The value is a 
number between 0.0 (edge separates two coplanar faces) and 1.0 
(or 180 degrees — neighbor faces are sandwiched back-to-back). 


reset-hardness edge to edge Generic Function 
Computes and updates the cached hardness value of the edge. 


slength of wire, segment, vector Method 
Returns the length of the edge. 


area face &optional bdi to face Generic Function 
Computes and returns the area of face. 


sbounds &optional matrix Method 
of locus, segment, face, polyhedron, object 
Computes and returns the bounds (minx, miny, minz, maxx, maxy, 
maxz) of the selected item. 


find-bounds-midpoint essential-3d-thing &optional matrix Generic Function 
to locus, segment, face, polyhedron, object 
Computes and returns the geometric midpoint of the element’s bounding 
box (midx midy midz). This midpoint is usually different from the 
geometric midpoint returned by find-bounds. 
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Messages for Modifying Elements 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


:collapse of face, edge, vertex Method 
Eliminates the selected item from the object and causes the object 
to collapse upon where that item was. Also, returns the item created 
by the collapse (a point when an edge or face is collapsed, or a face 
or edge [depending on whether the poin was isolated or not] when a 
point is collapsed). 


:dissolve of edge Method 
Eliminates the selected edge and causes the two adjacent faces to 
become one combined face. Returns the face created by the dissolve. 


:duplicate of body-mixin Method 
Creates a distinct copy of the selected body, duplicating all the 
elements and some of the properties of the selected body. The selected 
body and the copy do not share any elements. 


sextrude of face, edge, vertex Method 
Makes little faces around the element being extruded. 


smove dx dy dz of polyhedron, face, edge, vertex Method 
Moves the selected item in three space by the specified amounts. 


smove-out distance of face, edge, vertc« Method 
Moves the selected item along its normal by the specified distance. 


srandomize x-variation y-variation z-variation Method 
&optional (as-ratio-of-edge-length t) of polyhedron 
Randomizes the selected polyhedron by an amount scaled in each 
of the x, y, and z directions. 


srandomize-along-normals variation Method 
&optional (as-ratio-of-edge-length t) of polyhedron 
Randomizes each of the vertices of the selected polyhedron along 
the normals of each vertex. The amount of randomization is scaled 
by the specified variation. 
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srotate angle axis S&optional (cx QO) (cy O) (cz O) Method 


Rotates the selected item around the point (cx, cy, cz) around the 
specified axis by the specified angle. 


sxyz-rotate x-rot y-rot 2-rot &optional cx cy cz Method 


of polyhedron, face 
Rotates the selected item around (cx cy cz) by the specified angles, 
done in y-x-z order. 


sscale scaler &optional (cx 0) (cy 0) (cz 0) Method 


of polyhedron, face, edge, vertex 
Scales the selected item around its center by the specified amount. 


stwist degrees axis at-extent &optional (cx 0) (cy 0) (cz 0) Method 


(power 1.0) symmetric? of polyhedron 
Twists the polyhedron around its center. See page 114 for a 
description of the parameters. 


staper scaler taper-axis at-extent Method 


&optional (cx 0) (cy 0) (cz 0) (power 1.0) of polyhedron 
Tapers the polyhedron around its local origin. See page 116 for a 
description of the parameters. 


stranslate mover of locus, segment, face, polyhedron Method 


Translates the selected item by mover (anything that can be parsed 
as a triplet). 


sxyz-scale sx sy sz &optional (cx 0) (cy 0) (cz 0) (power 1.0) Method 


ref-power-value of locus segment face polyhedron 
Scales in x, y, and z the selected item arond the origin of the body 
to which it belongs. 
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Other Messages to Polyhedra 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


:transform-coordinates matrix Method 
Destructively transforms all vertices of a polyhedron by the supplied 
matrix. 

sinit-displacement locus-state-name &optional dont-check-lengths Method 

of polyhedron 

:<displace interp-value displacement-name Method 

of polyhedron 


Given two isomorphic polyhedra (same topology, but possibly differing 
geometry) :init-displacement associates the geometry of the second 
polyhedron with the first, and :displace sent to the first polyhedron 
modifies the location of its vertices to be intermediate between the two; 
a value of 0.0 makes it identical to its original shape, and a value of 1.0 
makes it identical to the shape of the second polyhedron. Values outside 
of the range of 0 to 1 result in extrapolations. 


:collect-vertices-in-bounds x1 yl zl x2 y2 22 &optional matrix Method 
of polyhedron 
Returns a list of all the polyhedron’s vertices that fall inside a cube 
defined by the bounding values. 


Messages to Polyhedra for Creating Internal Pieces 


The following are primitive messages to elements that you use to explicitly 
connect the element you are adding to its neighbors. When using these 
messages, you are responsible for the internal consistency of the polyhedron. 


:make-vertex xyz &optional (serial-num nil) Method 
(flav vertex) of polyhedron 
Makes a vertex and adds it to the vertex ring. 


smake-edge vtail vhead &optional (serial-num nil) (flav edge) Method 
of polyhedron 
Makes an edge and adds it to the edge ring. 
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:smake-face-from-vertices vix-list &optional Method 
(sertal-num (add1 (ser (get!-next-element face-ring-base))) 
(return-edge-list? nil) of polyhedron 
Makes a face from the supplied list of vertices and adds it to the 
polyhedron’s face ring. It checks to see whether edges between the 
vertices exist and creates them if they do not. 


smake-triangle-from-vertices pl p2 p3 of polyhedron Method 
:make-quadrilateral-from-vertices pl p2 p3 p4 of polyhedron Method 


Specialized forms of :make-face-from-vertices. 


:make-face-with-edges edge-list &optional serial-num Method 


of polyhedron 
Makes a face from the supplied edges. Since a face has only a 
pointer to one face, the effect of this method is to set that pointer 
and ensure that the relevant wings of these edges are set so that 
a closed ring is created. 


:make-triangle el e2 e3 &optional serial-num pl p2 p3 Method 


of polyhedron 


:smake-quadrilateral e1 e2 e3 e4 &optional serial-num pl p2 p3 p4 Method 


of polyhedron 
Specialized forms of the above. The optional point arguments are 
the trailing ends of the corresponding edges. 


skill of face Method 


Removes the face from its polyhedron’s ring. 
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Loop Paths 


Predefined iteration paths for the loop macro to traverse elements of 


S-Geometry’s database: 


vertex-ring-elements 

edge-ring-elements 

face-ring-elements 

(used with the special preposition of-polyhedron) 


Walks over the vertices, edges or faces of a polyhedron in last-added-first 


order. 


Many of these predefined iteration paths have short forms. The following 


three forms are equivalent to using the above. 


do-vertices iteration-list &body body 
do-edges iteration-list &body body 
do-faces iteration-list &body body 


For example, using the short form: 


(do-faces (f my-polyhedron) 
(send f :do-something) ) 


is identical to: 


Special Form 
Special Form 
Special Form 


(loop for f being the face-ring-elements of-polyhedron my-polyhedron do 


(send f :do-something) ) 


vertex-reverse-elements 

edge-reverse-elements 

face-reverse-elements 

(used with the special preposition of-polyhedron) 


Like the above, but in first-added-first order. 


Also: 
do-vertices-backward iteration-list &body body 
do-edges-backward iteration-list &body body 
do-faces-backward iteration-list &body body 
component-vertices 
component-edges 


Walks over the vertices or edges of a face in clockwise order. 


Special Form 
Special Form 
Special Form 
Special Form 
Special Form 


me 
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Also: 
do-face-vertices iteration-list &body body Special Form i 
do-face-edges iteration-list &body body Special Form | 
component-vertices2 
component-edges2 


(used with the special preposition of-face) 


Same as above, only includes some extra checking for maintaining order— 
generally not needed. 


Also: 
do-face-vertices-carefully iteration-list &body body Special Form 
do-face-edges-carefully iteration-list &body body Special Form 


ccw-component-vertices 
ccw-component-edges 
(used with the special preposition of-face) 


Walks counterclockwise over vertices or edges of a face. 


Also: 
do-face-vertices-backward iteration-list &body body Special Form 
do-face-edges-backward iteration-list &body body Special Form 
component-triplets 


(used with the special preposition of-face) 


Traverses periphery of face, maintaining pointers to the leading and trailing 
vertices, and optionally to the leading, trailing, and superleading edges as 
well. The iteration item is a list of three to six variables, the first of which 
is bound to each vertex of the face, the next two are bound to the vertices 
immediately clockwise and counter-clockwise on the face and the remaining 
three variables are bound to the trailing (counterclockwise) edges for each 
of the vertices. 


For example: 


(loop for (v v-back v-forward e e-back e-forward) 
being component-triplets of-face f do 
(send v :do-something-with v-forward) 


) 


There are no short versions of this special form. 
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node-elements 

all-point-elements 

segment-elements 

(used with the special preposition of-wire) 


Walks over the elements of a wire. 


Also: 
do-wire-nodes iteration-list &body body Special Form 
do-wire-segments iteration-list &body body Special Form 


vertex-neighbors 

edge-neigbors 

face-neighbors 

(used with the special preposition of-vertex) 


Traverses the neighbors of a vertex, in counterclockwise order. 


Also: 
do-vertex-vertices iteration-list &body body Special Form 
do-vertex-edges iteration-list &body body Spectal Form 
do-vertex-faces iteration-list &body body Special Form 


vertex-neighbors 
edge-neighbors2 
face-neighbors2 
(used with the special preposition of-vertex) 


Like the above, with extra checking. 


Also: 
do-vertex-vertices-carefully iteration-list &body body Special Form 
do-vertex-edges-carefully iteration-list &body body Special Form 
do-vertex-faces-carefully iteration-list &body body Special Form 
neighbor-triplets 


(used with the special preposition of-vertex) 


Traverses the vertex neighbors of a vertex, maintaining pointers to the 
previous and following ones, and optionally, their associated edges as well. 
The iteration item is a list of variables, as with the component-triplets path. 
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objects 

all-objects 

terminal-objects 

bdis 

bodies 

(used with the special prepositions of-object, of-list, or in) 


Loops over a set of objects or bodies. objects and all-objects hit every 
object in the target hierarchy. terminal-objects hits only those objects in 

a hierarchy with no (object) inferiors. bdis hit all the body-display-items 
(usually the immediate inferiors of terminal objects) in a hierarchy. bodies 
hit all the geometric bodies in a hierarchy. Of the possible targets, of-object 
indicates the target item is an object, of-list or in means the target item 

is a list of objects. 


For example, to loop through all the geometric bodies in the environment: 


(loop for b being the bodies in 3d:xglobal-object-listx do 
(send b :do-something) 


hy 


There are no short versions of this special form. 


Creating New Types of Bodies 


Objects, Body-display-items, and Bodies 


In S-Geometry, an object is a generalized entity that has a body and a body 
transformation matrix. A body is anything that can be be drawn and transformed. 
The basic sort of body in S-Geometry is the polyhedron, a polygonal structure 
using a winged-edge representation. Other bodies include wires, scaling centers, 
and rotation axes. 


Anything that is to be displayable in the 3D editor must be an object of flavor 
object, which is a relatively small instance that has variables: 


1 :body, which is either a primitive thing or a list of objects 

2 :mame, a string 

3 :body-matrix and 

4 :base-matrix, automatically made transformation matrices 
& a few others. 


After making a primitive thing, you should also make an object, setting its 
sbody to your thing and assigning it a name. 
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It is useful if you define your body using the special form: 
defgeoflavor name ivs components &rest options Special Form 


An extension to defflavor which allows the additional keywords 
:editable-element, :bodiable-element, and :attachable-body; 
meaning instances of this flavor can be, respectively, manipulated 
from S-Geometry, top-level geometric entities (bodies), or attachments 
(top-level bodies that have only an ancillary or supporting role). 


An object can also have as its body a list of other objects, so composite or 
hierarchical objects can be assembled. You can have many objects with the 
same primitive as its body. 


To make an object displayable, you must add it to the environment. You do 
this by calling add-object-to-view. 


This function automatically splices in, between the object and the body, a 
body-display-item (bdi), which is an instance that provides tables and flags 
to control and keep track of drawing the body. It too has a :body variable 
which becomes set to your body, while the object’s :body becomes set to 
the body-display-item. 


For everything to work properly, the primitive thing must prcvide several 
handlers for various messages the 3D editor might send (via the object). To 
simplify things until it can supply its own methods, any new body type can 
mix in dummy-body-mixin, which provides no-op handlers for the following: 


:find-high-serial-numbers 
In order for the window to keep track of screen positions, each 
element of a body must be given a serial number unique within 
the body; thus any element-creation methods should assign an 
incremented serial number to any new elements. 


This method should return the three highest serial numbers of 
each of the (currently) three basic display types: points, segments, 
and polygons. 


A primitive that has no elements of one or more of those types 
should return (at present) 0, so that, for instance, a primitive that 
had only 24 consecutively numbered points, starting at 1, would 
return 2400. This is used for setting up body-display-items, 
provided by the editor. 
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:count-up-elements &optional ignore (skip-faces nil) 


Resembles :find-high-serial-numbers, but returns actual count 
of elements of each type (which would differ from the method 
:find-high-serial-numbers by one plus the extent to which the 
serial numbers are not consecutive), nil if none. 


:draw-self window bdi &optional alu obmat 


This is already provided when the primitive is built on point, 

segment, face, polyhedron, wire, or other existing flavors. If the 
primitive has elements built on these, the method for the primitive 

need only loop through its elements, sending each a :draw-self 

message, passing on the arguments, if not, then you must deal with 

the 3D editor window for transformations, line-drawing, etc. The method 
need not really do anything with the arguments, but they are there for 
reference to arrays in the bdi, to change the ALU, etc. 


If you do not want to maintain serial numbers for each element, 

tables of transformed points in the bdi, tables of screen positions 

in the 3D editor, or the like, and do not need screen sensitivity or 

access to any transformed values, the :draw-self method can simply 

have each element send the window a :draw-3d-point (x.y z &optional alu) 
or :draw-3d-line (x1 yl zl x2 y2 22 &optional alu draw-last-point) 

message, which draws points or lines directly, without referring to any 
tables (but might end up being a bit slower). 


Other messages of bodies sent for sundry effects; they should be 
present even if they do nothing, since various functions in the 3D 
editor call them, and do not check whether or not the handler exists 
(this might be changed). 


:describe-geometry optional (stream t) bdi serial-nums-only 


(print-self t) 
Displays any information relevant to the geometry of the body. 


:describe-topology &optional (stream t) bdi serial-nums-only 


(print-self t) 
Displays any information relevant to the topology of the body. 
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:display-self-briefly window &optional (bdi nil) (name-width 0) Method 
(depth 0) (offset 8) (fillchar #\space) of polyhedron 

Prints a one-line explanation of itself to stream. bdi can be used 
to extract additional information, such as the name of the object to 
which the body belongs. width provides for uniform formatting of 
names of the various primitive types — the name of the body type 
is usually printed left-justified in a block width wide. depth, offset, 
and fillchar can be supplied for indentation control from body to 
body. The body description is output on the stream depth*offset 
fillchars from the left margin. depth is typically based on the 
body’s level in the object hierarchy; zero represents the top level, 
offset is usually a constant (a good default is 3), and fillchar is 
normally the space character. 


:display-self window &optional (6di nil) 
Displays as much information about the thing and all its elements 
as plausible, usually as a table. 


sn-opaque-elements 
This should return the number of elements that are to be considered 
opaque for the purposes of the opaque-faces facility. While this 
means faces in the case of polyhedra, it might refer to any element 
type. For example, the opaque elements of wires are its segments. 


:push-yon-elements f-table start-idx w bdi 
Adds depth information into face-table for the hidden-line eliminator, 
starting at start-index, and returns start-index incremented by 
however many items are added. If a dummy method, it should 
return the start-index given it, and the body will not be visible in 
any scene drawn via :redraw-image. If this is not a dummy method, 
the :n-opaque-elements method must also be provided so that S-Geometry 
can allow enough table space for these elements. 


:number-elements type window bdi &optional (font tvfontl) 
(dest window) 
To display all element serial numbers on the screen. 


:find-my-body 
The body returns self; elements should have a way of referring to their 
body. 
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find-midpoint Generic Function 
Finds geometric center of body. Used for aiming at an object, and other 
sundries. 

:make-bounding-body 


Builds a polyhedral box around body for faster repositioning. 


:display-screen-points window point-table up-table 
Goes to the window to get transformed point information. 


sread-file stream S&optional trans-matrix ignore-index-nums 
Reads, from a file, a sufficient description of the body to be able to 
reconstruct it. 


:write-file out &optional (scale 1) numbered-p (depth-level 0) 
Outputs to out-stream a description of the body’s data in a form 
readable by :read-file. 


sbounds &optional matrix 
Gives the minimum and maximum values, in x, y, and z, of the body 
in its home position. 


:make-bounding-body 

sresize-bounding-body bounding-body 
Optional messages to build and modify, respectively, a simpler repre- 
sentation of the body for faster repositioning. If these messages are 
not supplied, a box-like polyhedron is made using the :bounds message. 


:duplicate 
Returns a new body, all of whose elements are geometrically and 
topologically equivalent to the original. This message should also 
replicate any attributes, etc. 


If you are maintaining element serial-numbers for screen sensitivity etc., you 
must make the display tables larger after increasing the size of an object, by 
sending one or more of the following messages: 


sincrement-v-array amount 

:increment-e-array amount 

:increment-f-array amount 

with the increment value, to the body’s 
body-display-item(s) and to the window. 
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Alternatively, you can maintain the global variables *vertex-counter*, 
*edge-counter*, *face-counter*, which contain no special information, but 
are there for the using. They can be incremented when making any additions 
to the body of that type; then, when all additions are finished and before 
display, a call to increment-display-arrays (bdi window) automatically 
increments the proper arrays by the values in these variables. Note: The 
variables should be zeroed between the last call to increment-display- 

arrays and any further additions. 


Canonical Types 


Two canonical file types are currently defined by S-Geometry. 


:object files are objects defined in S-Geometry format and the normal extension 
on Lisp Machines is ".obj". 


The :camera type files are descriptions of camera views. Their extensions 
are ".cam", 


Useful Mathematical Functions 


Note: All numeric data must be entered in single-precision floating-point form. 
To get around this restriction, see the section "Inputting Numeric Data." 


make-linear-transform-matrix &optional (init-code 0) Function 
Makes an instance of the linearized 4x4 matrix used by S-Geometry. 


transform-coordinates x y z matrix Function 
Multiplies the vector represented by the coordinates x, y, and z by 
the matrix (which must be of the linearized sort created by 
make-linear-transform-matrix). 


locus-distance locus1 locus2 Function — 
Distance between two locus-based instances. 


initialize-3d-matrix matrix &optional (transform-code 0) Function 
Makes the supplied matrix an identity matrix. 


invert-3d-matrix matrix &optional into-matrix Function 
Inverts a linearized 4x4 matrix. 
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multiply-3d-matrices matrix1 matrix2 matrix-out Function 
&optional (transform-code nil) 
Multiplies two linearized 4x4 matrices. 


alter-3d-matrix matrix &rest keyword-args Function 


Known keywords: 
(v) means argument (string, list, locus, vector, etc.) is parsed as a 
triplet (matrix) means argument is a 3d-linear-transformation-matrix, 


otherwise arg is assumed to be a number; bracketed keywords are 
equivalent: , 3 


{initialize :init} (supply dummy arg) 
scopy (matrix) 

:concatenate (matrix) 

{:smove :uncenter (v)} 

{:center :unmove (v)} 

:X-move :y-move  :z-move 
:scale (v) 

sx-scale :y-scale :z-scale 
:x-shear (v) :x-sheary :x-shearz 
:y-shear (v) :y-shearx :y-shearz 
:Z-shear (v) :z-shearx :z-sheary 


:align (v) (specify local vector — global z) 
:align-local (v) (specify local vector — local z) 
(align-to :unalign (v)} (specify global vector — local z) 
salign-y (v) (specify local vector — global y) 


(:align-y-to :align-up (v)} (specify global vector — local y) 
srotate (v) :unrotate (v) (degrees) 

sx-rot :y-rot :z-rot (degrees) 

-x-rotr :y-rotr :z-rotr (radians) 


Builds a matrix from an arbitrarily long concatenation of simple operations. 


show-matrix matrix &optional (window t) (float-precision 4) Function 
Prints out the linearized matrix in 4x4 form. 


Glossary 


Aimpoint. The point at which the camera is aimed. It is always the 
center of the field of view at an arbitrary distance from the eyepoint. 


Body. The inferior of an object. A body can consist of either a top-level 
geometric entity (a geobody such as a polyheron or wire) or a list of 
objects. 


Body transformation matrix. Information that describes the position, 
rotation, and scale of an object. 


Compound object. An object whose body is a list of objects. 


Element. Any of the constituent parts that make up a body. Elements 
include vertices, edges, faces, and polyhedron. 


Encode. Encoding in S-Geometry refers to manually specifying the 
coordinates of elements. 


Eyepoint. The point in space from which the camera looks. The 
appearance of a scene is determined by the location of the camera, the 
direction in which it is pointed, usually expressed explicitly as a vector or 
implicitly as an aimpoint, and the angle of view which the camera takes in. 


Geobody. Any type of geometric entity that is self-contained, that is, not 
an element of another geometry entity. Geobodies currently implemented 
in S-Geometry include polyhedra and wires. | 


Inferior object. A member of a list of objects that makes up the body of 
another object. 


Instancing. Sharing of aa bodies between more than one object. 
Move. Any linear displacement in space. 

Multiple object. See Compound object. 

Normal. The normal of an edge is denned to be the average of the 


normals of the edge’s adjacent faces. The normal of a vertex is defined to 
be the average of the normals of the vertex’s adjacent faces. 
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Object. The viewable representation of the geometric form and the body 
transformation matrix. An object has geometric properties and location. 


Polygon. A set of noncrossing straight lines that join points that all lie on 
the same place and enclose an area. 


- Pan. A type of rotation in which the camera freely orients itself from a 
fixed location; the camera is not constrained to point at a particular 
aimpoint. . 


Part. A collection of one or more elements of the same type. 


Rigid-body transformation. An operation, such as move, scale, rotate, 
that is performed on an object without distorting it. 


Shift. A linear translation of the camera in which the camera maintains 
its fixed, global orientation. 


Superior. Regarding an object, another object which has that object as its 
body. 


Swept angle. Specifies the fullness of a rotational solid. A complete, 
circular cylinder has a swept angle of 360 degrees; a half cylinder has a 
swept angle of 180 degrees. 


Swing. A camera motion during which the camera follows a circular path 
around a an aimpoint; the camera constantly reorients itself to remain fixed 
on this aimpoint. 


Top-level object. An object that has no superior. 
Translation. A linear movement. 


View angle. The solid angle between the planes representing the left and | 
right boundaries of the field of view. 


Wedge-cut. Describes a cylinder with a spine created down the center that - 
connects the edges of the cylinder to the spine. See page 53 for a diagram 
of a wedge-cut sphere. 
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index 


“fixed-aim-variable* 
*global-object-list* 
*reuse-existing-versions-of-objects* 
*reuse-similarly-named-objects* 
*visible-object-ist* 
12-field chart 

Displaying continuously 
3d-editor-window 
3D live window 
3d :make-3d-editor 
3D package 
3d-viewer-window 
-add-main-menu-item 
:add-new-primitive 
add-object-to-view 
[Add to Part] 
[Aim] 
Aim-distance 
aimed-locus 
:aimpoint 
Aimpoint 

specifying 
[Align] 
:align-to 
alter-3d-matrix 
Ambient light 
Arc sampling 
Aspect ratio 
[Assign UV Coordinates] 
Attachments 

Displaying 
Attributes 
Attributes menu 

Bringing up through mouse clicks 
Auto ranging 
Auto-ranging 
Axes 

Displaying and labeling 

Specifying axis length 
[Axis Rotate] 
[Axis Scale] 
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-back 182, 191 
[Backfacing] 149 
tbake-current-transformation 189 
[Bake This] 99 
Baking 5 
[Bevel] 112 
Bitmap screens 156 
Bitstream fonts 

See Fonts 77 
:bless 200 
[Biess} 81,114 
Body 2 
body-display-item 8 
sbounds 213 
[Bridge] | 114 
camera 178 
Camera 2 
Camera direction 2 
Camera format TO 

Specifying a site default 38 
camera-mixin 178 
Camera Motion menu 19 
:ccw-local-rotate 184 
[Chip Off] 116 
choose-object 187 
ci:float A77 
Clipping planes 2 

Continuous adjustment 34 
[Collapse] 116 
Collect mode 103 
Color hardware 156 
Color screen 156 
Color Windows 

Creating without color hardware 156 
Compound object 4 
Contours 54 
Contour solid 72 
[Convexify] 117 
:coordinates 200 
[Coplanar] 118 
[Copy] 119 

vs [Reinstance] 69 
[Copy, mirrored] 120 
:count-up-elements 211 
Cross sections 54 
[Cut] 120 
:cw-local-rotate 184 
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defgeoflavor 
[Describe] 
:describe-geometry 
:describe-topology 
:displace 
[Displace] 
Displacements 
:display-screen-points 
:display-self 
:-display-self-briefly 
[Dissolve] 
:down 
:down-ocal-rotate 
:draw-3d-line 
:draw-3d-point 
:draw-self 
:duplicate 
:duplicate 
dynamic-eyepoint-mixin 
[Edge Subdivide] 
Elements 
Binding to f 
Displaying serial numbers 
Operations 
Selecting 
Encoding 
Modifying cursor parameters 
encoding-mixin 
essential-3d-thing 
[Evert] 
-extrude 
[Extrude] 
-eyepoint 
Eyepoint 
[File] 
-find-high-serial-numbers 
find-midpoint 
:find-my-body 
[Flatten] 
[Flip] 
[Flip Path] 
float 
Floating-point numbers 
Coercing generalized numeric values 
Fonts 


Keyboard assignment of symbols and accents 


Transforming 
‘forward 
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[Fractalize] 126 
Full-box cursor 84 
General faces 108 
Geobody 2 
geometry-edit-mixin 179 
Geometry frame 11 
geometryframe 179 
geometryframe 178 

Manipulating windows and panes 161 
[Get] Ae 
[Global] 22 
Global coordinate system 1 

Toggling between a local coordinate system 22 
Global origin 1 >’ 
Grid 51 — 
[Grow] 127 — 
Half-box cursor 84 zB . 
[Hardcopy] 155 ) 
[Hard Edging] 150 ll 
hidden-line-mixin 179 | 
hide-all-objects 188 7 
Hither clipping plane 2 a . 
Hither distance 2 ‘a 
Home position 5 |. 
Icosahedron 33 
Inferior objects 7 ‘ 
Infinite light 47 = 
[Initialize] 91 
initialize-3d-matrix 214 | 
-initialize-transformation 189 _ 
[Inset] 128 
Instancing 3,8 ; ll 
invert-3d-matrix 214 _ 
isolate 188 hi 
kill-all-objects 188 i: 
Killing objects 145 ¥ 
kill-object 188 _ & 
Lamina 69 \—— 
left 182 
sleft-local-rotate 184 — 
[Level] 42 ~ 7 
[Lift Edge] 128 
[Lift Vertex] 128 
Light groups 50 
Lights 46 

Creating 46 

Manipulating ao 


Specifying color 47 
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Loading S-Geometry 
Local coordinate system 
Local coordinate systems 
[Local Shear] 
locus-distance 

Loop paths 

MAIN menu 


_ make-3d-editor 


:make-bounding-body 
:make-bounding-box 
make-bounding-box 
make-cube 
:make-edge 
:make-face-from-vertices 
:make-face-with-edges 
:make-invisible 
:make-linear-transform-matrix 
:make-quadrilateral 
:make-triangle 
:make-triangle-from-vertices 
:make-vertex 
:make-visible 
Menu conventions 
[Mirror] 
Modes menu 
Modification menus 
Bringing up 
Mouse 
Mouse speed 
Adjusting 
:move 
[Move] 
[Move Along Axis] 
:move-local 
:move-local-with-aim-fixed 
smove-out | 
Moves 
:move-to 
:move-to-with-aim-fixed 
:move-with-aim-fixed 
Multiple object 
multiple-view-mixin 
multiply-3d-matrices 
[New Displacement] 
[New Spline] 
Nodes 
Displaying 
Nonplanar faces 
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:n-opaque-elements 
:number-elements 
Numeric values 
Inputting 
obdi 
OBJECT DISPLAY menu 
:object-named 
object-named 
Objects 
Comparing filenames 
Grouping 
Hardcopying 
Internal numbering 
Killing 
Making visible or unvisible 
Manipulating by using numeric input 
Printing serial numbers 
Printing topological and geometric information A285 
Reading in from file 
Renaming 
Rendering 
Restoring killed objects 
Saving to file 
Shading 
objects-modified-since-save 
objects-of-type 
obod 
Octahedron 
Opaque faces 
Removing 
Operations with influence 
OUTPUT menu 
Overlays 
Panes 
Burying 
Hiding 
Killing 
:pan-horizontal 
:pan-horizontal-to 
Panning 
:pan-right 
span-up 
:pan-vertical 
:pan-vertical-to 
Parts 
[Parts] 
Saving 
Pie-cut poles 


pitch 
Point light 
Points 


Specifying the size in pixels | 


Polar axis 
Polyhedra 
Creating from a menu 
Messages for creating 
[Position] 
:push-yon-elements 
randomize 


-read-file 
readin-object 
redraw 
:redraw-image 
-reinstance 
[Reinstance] 

vs [Copy] 
[Rename] 
[Render] 
[Repline] 
:resize-bounding-box 
[Respline] 
[Restructure] 
‘right 
:right-local-rotate 


Rigid-body transformations 


Ring? 

roll 

rotate 

[Rotate] 
:rotate-crientation 
Rotation axis 

[Save] 
save-ali-objects 
:scaie 

[Scale] 

Scaling center 
screen-slement 
screen-record-mixin 
Screen stretch factor 
[Select] 
:send-ali-bdi 

Serial numbers 


Displaying 


184, 190 


75 

184, 190 
189, 203 
93, 135 
182 


188 
192, 203 
95, 135 
143 
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Displaying for elements 144 
:set-aimpoint 181 
:set-aspect-ratio 185 
set-azimuth 181 

_ get-direction 182 
:set-elevation 181 
:set-eye-and-aim 181 
:set-eyepoint 180 
set-orientation 181 
:set-pitch 181 
[Setg j] 142 
:set-roll 181 
:set-x 180 
:set-y 180 
:set-y-aim 181 
:set-yaw 181 
set-z 180 
:set-z-aim 181 
S-Geometry 

Loading, entering 9 

Minimum software requirements 9 
[Shade] 159 
[Shear] 98 
:shift-eyepoint 180 
Shifts ae 21 
[Show] 99 
show-matrix 215 
[Silhouetting] 149 
Simple object 3 
Sketch axis 75 
Sketching 

Practice session 61 
Sketching arcs 
Sketching worksheet 54 

~ [Smooth] 136 
Solid of rotation 66 
[Sphericize] 136 
Substitute Boxes 152 

Displaying at all times or only during moves 35 
Superiors ; 7 
Swept angle 75 
Swing ee ; 20 
:swing-horizontal 183 
:swing-horizontal-to 183 
:swing-right 183 
:swing-up 183 
:swing-vertical 183 


:swing-vertical-to 183 


Tablet 
Encoding 
taper 
[Taper] 
Terminal objects 
Tetrahedron 
Three-arm cursor 
-top-level-object 
Top-level object 
Topology 
Changing 
Toroidal 
Transformation matrices 
Displaying in 3D five window 
Saving 
Transformation matrix 
Changing 
:transform-coordinates 
transform-coordinates 
:transiate 
Tube 
Tube solid 
TV safe area 
Displaying continuously 
TV safe areas 
:twist 
[Twist] 
“up 
:Up-local-rotate 
[Vertex Subdivide] 
Vertices 
Displayint 
View 
Saving 
View angle 
Viewer 
Viewing volume 
View window 
view-window 
Creating multiple windows 
[Visible] 
Wedge-cut 
Write-file 
Writeoul-object 
:X-Move 
>X-Move-aim 
-X-Move-local 
:X-move-local-with-aim-fixed 


213 


182 


182 
182 
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228 ¢« S-Geometry 


>X-Mmove-to 
:x-move-to-with-aim-fixed 
x-rotate 

:X-rotate-ipcal 

‘x-shear 

:xyz-rotate 
*xyz-rotate-local 
*xyz-scale 

[XYZ-Scale] 

-yaw 

7y-move 

-y-move-aim 
-y-move-idécal 
-y-move-iscal-with-aim-fixed 
-y-move-to 
7y-move-to-with-aim-fixed 
:y-move-with-aim-fixed 
Yon clipping plane 

Yon distance 

-y-rotate 

:y-rotate-local 

:y-shear 

2i:float 

Z-Move 

“Z-move-aim 
:2-move-iocal 
:Z-move-local-with-aim-fixed 
:Z-move-to 
:Z-move-to-with-aim-fixed 
:Z-move-with-aim-fixed 
Zooming 

-z-rotate 

:2-rotate-local 

:z-shear 
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